mcp-markets 0.9.4

全市场金融数据 MCP Server — A股/港股/美股/期货 行情/K线/技术指标/选股/回测 基于 easy-tdx + AKShare + yfinance 三数据源

mcp-finance

MCP Server for Global Financial Markets
29 tools · 3 markets · Millisecond-level quotes

English · GitHub · PyPI

---

简介

mcp-finance 是一个面向 AI 助手（Claude / Codex / Cursor 等 MCP 客户端）的金融数据服务，基于 easy-tdx（通达信毫秒级） + AKShare + yfinance 三数据源，覆盖 A股、港股、美股、期货四大市场，提供行情、K线、技术指标、选股、回测、分析等 29 个工具。

---

安装

pip install mcp-markets

Python 3.10+，核心依赖：easy-tdx akshare plotly backtrader pandas numpy pydantic。

---

配置 MCP 客户端

Claude Desktop

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "mcp-finance": {
      "command": "python",
      "args": ["-m", "mcp_finance.server"]
    }
  }
}

Codex

codex mcp add mcp-finance -- python -m mcp_finance.server

Cursor / VS Code

{
  "mcpServers": {
    "mcp-finance": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "mcp_finance.server"]
    }
  }
}

---

全部工具 (29)

行情

工具	说明	覆盖
get_realtime_quote	单股实时行情	A股/港股/美股/期货
batch_quotes	批量行情查询	A股/港股/美股
get_market_indices	大盘指数	上证/深证/恒生/道琼斯等
get_futures_list	期货主力合约列表	国内商品+股指期货
search_stock	股票搜索（本地毫秒级）	A股/港股/美股

K线

工具	说明	覆盖
get_kline	日/周/月K线，支持前/后复权	A股/港股/美股/期货
get_minute_kline	分钟K线（1/5/15/30/60分钟）	仅A股

技术分析

工具	说明
get_technical_indicators	MA/MACD/KDJ/RSI/BOLL/WR/BIAS + 金叉死叉/超买超卖信号
plot_kline	交互式K线图（蜡烛图+均线+MACD/KDJ/RSI副图）
comparison_chart	多股走势对比图（归一化）

财务与市场

工具	说明
get_financials	核心财务数据（营收/净利润/ROE等）
get_sector_ranking	行业/概念板块涨幅排行
get_north_flow	北向/南向资金流向
get_dragon_tiger	龙虎榜每日明细
get_block_trades	大宗交易明细
get_margin_trading	融资融券数据

资金与机构

工具	说明
get_fund_flow	主力净流入（easy-tdx 实时）
get_institutional_holdings	十大流通股东

宏观与研报

工具	说明
get_macro_data	GDP / CPI / PMI / 货币供应量 / 外汇储备
get_research_reports	个股研报（机构评级/盈利预测）

选股

工具	说明
stock_screener	全市场条件筛选（涨跌幅/量比/PE/PB/ROE等）
factor_screener	五因子打分排名（动量/价值/质量/增长/波动）

回测

工具	说明
backtest_strategy	8种策略回测（双均线/MACD/RSI/KDJ/BOLL/海龟/波动率/均值回归）
optimize_strategy	参数网格扫描优化
portfolio_backtest	多股组合回测（支持自定义权重）

分析

工具	说明
analyze_stock	综合评分（行情+技术+财务+均线 0-100分）
compare_stocks	多股横向对比排名
correlation_matrix	相关性矩阵 + 低相关配对

系统

工具	说明
test_data_sources	诊断所有数据源可用性

---

使用示例

场景	对话示例
查行情	"茅台(600519)现在什么价？"
画K线	"画一张茅台120天日K线图，带上MACD和RSI"
技术分析	"分析比亚迪的技术指标，有没有金叉信号？"
看资金	"茅台今天主力净流入多少？"
条件选股	"涨超3%、量比>1.5、换手率>5%、PE<30的股票"
多因子	"五因子打分排名前20的A股"
策略回测	"双均线(5,20)回测美的集团2024年全年"
参数优化	"找美的集团双均线最优参数"
投资组合	"茅台+宁德+招行等权组合回测近一年"
个股分析	"给我一份茅台的综合分析报告"
多股对比	"对比茅台、五粮液、老窖、汾酒"
相关性	"茅台和五粮液的相关性？"
宏观数据	"最近一年CPI数据"
看研报	"茅台最新机构研报"
港股美股	"腾讯港股 / 苹果股票 什么价？"

---

---

Web Dashboard

mcp-finance 内置了一个本地 Web 界面，将 MCP Tools 的能力包装为可视化面板：

# 启动 Dashboard（默认 http://localhost:8080）
mcp-dashboard
# 或指定端口
mcp-dashboard --port 3000

功能页面

页面	说明
行情总览	大盘指数、热门股票、行业/概念/地域板块排行、北向资金流向、个股K线速查
选股器	多因子排行（综合评分+动量+活跃度）+ 条件选股（涨跌幅/换手率/量比/PE/PB/市值/ROE）
策略回测	8 种策略（双均线/MACD/RSI/KDJ/BOLL/海龟/波动率趋势/均值回归），交互式权益曲线，交易记录明细

设计

• 双数据源：TDX（毫秒级行情+选股） + AKShare（财务/PE/PB/ROE，仅交易时段）
• 选股器优先使用 TDX（~3s 全市场扫描），交易时段可切换 AKShare 获取完整财务数据
• 响应式 UI，shadcn-inspired 设计系统
• Plotly 交互式图表

数据源

数据源	说明	延迟
easy-tdx	通达信 TCP 直连，主力行情/K线/资金流向	毫秒级
AKShare	新浪/同花顺/东方财富，财务/板块/龙虎榜/研报	秒级
yfinance	Yahoo Finance，港股美股兜底	秒级

---

项目结构

mcp_finance/
  server.py           MCP 路由与工具注册
  api.py              三数据源封装层
  api_extended.py      分钟K线 / 资金流向 / 机构持仓 / 宏观 / 研报
  analysis.py          综合评分 / 多因子选股 / 多股对比
  portfolio.py         组合回测 / 相关性矩阵
  indicators.py        9大技术指标 + 信号识别
  backtest.py          Backtrader 回测引擎
  chart.py             Plotly 交互式图表 / 对比图
  screener.py          全市场选股器
  cache.py             TTL 内存+磁盘缓存
  validators.py        Pydantic 参数校验
  errors.py            统一错误处理
  logging_config.py    日志配置
tests/
  test_indicators.py   指标单元测试
  test_screener.py     选股器单元测试

---

开发

git clone https://github.com/ojkkk/mcp-finance.git
cd mcp-finance
pip install -e ".[dev]"
pytest tests/ -v

---

License

MIT