mcp-markets 0.12.8

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

mcp-markets

全市场金融数据 MCP Server
让 AI 助手看懂 A股 · 港股 · 美股 · 期货

---

⚡ 快速开始

`ash pip install mcp-markets

方式一：作为 MCP Server 运行（供 Claude / Codex / Cursor 调用）

python -m mcp_finance.server

方式二：启动内置 Web Dashboard

mcp-dashboard # 默认 http://localhost:8080 `

Python 3.10+ · 零配置即可使用 · 可选设置 TUSHARE_TOKEN 环境变量启用高级财务数据

---

📊 功能全景

`mermaid graph LR A["📡 数据源"] --> B["⚡ easy-tdx
通达信TCP · 毫秒级"] A --> C["🌐 AKShare
新浪/同花顺/东方财富"] A --> D["🌍 yfinance
Yahoo Finance 兜底"] A --> E["📈 Tushare
PE/PB/ROE 深度财务"]

B --> F["🔧 31 MCP Tools"]
C --> F
D --> F
E --> F

F --> G["📈 行情<br/>实时价/批量/K线"]
F --> H["🔬 技术分析<br/>MA·MACD·KDJ·RSI·BOLL"]
F --> I["📋 选股<br/>条件筛选·五因子排名"]
F --> J["⚙️ 回测<br/>9策略·贝叶斯优化"]
F --> K["📊 组合<br/>多股对比·相关性·Portfolio"]
F --> L["🏢 基本面<br/>财务·研报·龙虎榜·大宗"]
F --> M["🖥️ Dashboard<br/>Flask Web · 深色主题"]

style A fill:#1a1a2e,stroke:#e94560,color:#fff
style F fill:#16213e,stroke:#0f3460,color:#fff
style G fill:#0f3460,color:#fff
style H fill:#0f3460,color:#fff
style I fill:#0f3460,color:#fff
style J fill:#0f3460,color:#fff
style K fill:#0f3460,color:#fff
style L fill:#0f3460,color:#fff
style M fill:#e94560,color:#fff

`

---

🎯 全部 31 个 MCP 工具

行情报价

工具	功能	数据源	延迟
get_realtime_quote	单股实时行情 (现价/涨跌幅/量比/换手率)	easy-tdx → AKShare → yfinance	< 100ms
atch_quotes	批量查询多只股票行情	easy-tdx	< 1s / batch
get_kline	日/周/月 K线 + 前/后复权	easy-tdx (A) / AKShare+yfinance (港美股)	< 500ms
get_minute_kline	1/5/15/30/60 分钟K线 (仅A股)	easy-tdx	< 200ms
get_market_indices	A股 / 港股 / 美股 大盘指数	easy-tdx → AKShare	< 500ms
get_futures_list	国内期货主力合约行情	AKShare 新浪	~1s
search_stock	代码/名称模糊搜索	本地映射	即时

技术分析

工具	功能
get_technical_indicators	MA·MACD·KDJ·RSI·BOLL·WR·BIAS + 金叉/死叉/超买超卖/均线排列自动识别
plot_kline	交互式 K线HTML (蜡烛图+均线+成交量+MACD/KDJ/RSI副图)

选股 & 分析

工具	功能
stock_screener	11维条件选股 (涨跌幅/量比/换手率/PE/PB/ROE/市值…)
actor_screener	五因子综合打分排名 (动量·价值·质量·增长·波动)
nalyze_stock	一站式个股分析报告 (行情+技术+财务+综合评分 0-100)
compare_stocks	多股横向对比，按评分排名
correlation_matrix	收益率相关性矩阵 (辅助分散投资)

回测 & 优化

工具	功能	策略
acktest_strategy	个股策略回测	双均线·MACD·RSI·KDJ·BOLL·海龟·波动率趋势·均值回归·自定义组合
optimize_strategy	网格扫描 / Optuna TPE 贝叶斯优化	自动剪枝 + 参数重要性分析
portfolio_backtest	多股组合回测	自定义权重 / 等权分配

市场数据

工具	功能
get_sector_ranking	行业/概念板块涨跌排行
get_north_flow	北向/南向资金流向
get_fund_flow	个股主力资金净流入 (easy-tdx 毫秒级)
get_dragon_tiger	龙虎榜 (营业部买卖明细)
get_block_trades	大宗交易明细
get_margin_trading	融资融券数据
get_macro_data	中国宏观经济 (GDP/CPI/PMI/M2/外汇储备)

基本面

工具	功能
get_financials	5大类19+指标 (核心/盈利/成长/风险/营运)
get_institutional_holdings	十大流通股东 / 机构持仓
get_research_reports	机构研报 (评级+目标价)
comparison_chart	多股走势对比图 (归一化交互HTML)
est_data_sources	一键诊断所有数据源可用性

---

🖥️ Web Dashboard

内置 Flask Web 界面，可视化所有 MCP 工具能力。

`ash mcp-dashboard # http://localhost:8080 mcp-dashboard 3000 # 指定端口

或双击 start_dashboard.bat (Windows)

`

页面	路由	功能
行情总览	/	大盘指数 · 热门股票 · 板块排行 · 北向资金 · K线速查 · 股票搜索
选股器	/screener	五因子排名 · 条件选股 (11维) · 实时筛选
策略回测	/backtest	9策略回测 · 网格/贝叶斯优化 · Walk-Forward · 蒙特卡洛

深色主题 · Plotly 交互图表 · 响应式布局

---

🔌 配置 MCP 客户端

Claude Desktop

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

Codex

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

Cursor / VS Code

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

可选：启用 Tushare 财务数据 — 设置环境变量 TUSHARE_TOKEN=你的token（注册 tushare.pro 免费获取）。未设置时自动降级，不影响基础功能。

---

🏗️ 四数据源架构

┌─────────────────────────────────────────────┐ │ MCP Tools │ ├─────────────────────────────────────────────┤ │ api.py ── 三源智能路由 │ │ ├─ A股 实时/K线 → easy-tdx (毫秒级) │ │ ├─ 板块/财务/龙虎榜 → AKShare (秒级) │ │ ├─ 港美股行情 → AKShare → yfinance 兜底 │ │ └─ 深度财务 → Tushare (可选Token) │ ├─────────────────────────────────────────────┤ │ ⚡ easy-tdx 通达信TCP · 协议逆向 · 延时<50ms │ │ 🌐 AKShare 新浪/同花顺 · 网页爬虫 · 延时~1s │ │ 🌍 yfinance Yahoo · 非官方 · 延时~2s │ │ 📈 Tushare Token鉴权 · 需积分 · 延时~1s │ └─────────────────────────────────────────────┘

---

🧪 测试 & 开发

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

运行测试

pytest tests/ -v

代码检查

ruff check mcp_finance/ `

---

🌟 AI 对话示例

场景	自然语言提问
行情	"茅台现在什么价？" / "腾讯港股和苹果美股今天表现如何？"
技术分析	"茅台 MACD 金叉了吗？RSI 到什么位置了？"
选股	"找涨超3%、量比>1.5、PE<30 的股票" / "五因子排名前20"
回测	"双均线(5,20)回测茅台2024年全年" / "找茅台最优MACD参数"
组合	"茅台+宁德+招行等权组合回测近一年"
分析	"给我茅台的综合分析报告" / "对比茅台、五粮液、老窖"
市场	"最近CPI数据" / "北向资金最近在买什么？"
研报	"看看机构对茅台的最新评级"

---

⚠️ 免责声明

本工具仅供学习交流，所有数据仅供参考，不构成任何投资建议。

• 数据来源于第三方公开接口与网页爬虫，不作准确性、完整性、及时性保证
• 无自有数据源，全部依赖 easy-tdx (通达信公开TCP) / AKShare (网页爬虫) / yfinance / Tushare
• 数据无合规商业授权，个人非商用无问题，企业商用存在版权与合规风险
• 回测结果不代表未来表现，历史收益不预示未来收益
• 作者不对任何投资损失承担责任 · 投资有风险，入市需谨慎

---

📄 License

MIT © mcp-markets