mcp-markets

Python

⚡ 快速开始

pip install mcp-markets

# 方式一：作为 MCP Server 运行（供 Claude / Codex / Cursor 调用）
python -m mcp_finance.server

# 方式二：启动内置 Web Dashboard
mcp-dashboard              # 默认 http://localhost:8080

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

✨ 核心能力一览

模块	功能	亮点
📈 实时行情	A股/港股/美股/期货/指数	easy-tdx 毫秒级，三源自动降级
📊 K线数据	日/周/月/分钟 K线，前/后复权	A股 800 条，港美股 yfinance 兜底
🔬 技术指标	MA·MACD·KDJ·RSI·BOLL·WR·BIAS	金叉/死叉/超买超卖自动识别
🔍 选股器	11 维条件筛选 + 五因子排名	动量·价值·质量·增长·波动
🧪 策略回测	9 大策略 + 参数优化	Backtrader 事件驱动，125× 性能提升
💼 组合分析	多股对比 + 相关性矩阵 + 组合回测	支持等权/自定义权重
🏢 基本面	财务指标 / 机构持仓 / 研报 / 龙虎榜	AKShare + Tushare 双源
🖥️ Web 看板	Flask 实时行情 Dashboard	Plotly + ECharts 交互图表

🏗️ 四数据源架构

graph LR
    A["📡 数据源层"] --> B["⚡ easy-tdx<br/>通达信 TCP · <50ms"]
    A --> C["🌐 AKShare<br/>新浪 / 同花顺 / 东方财富"]
    A --> D["🌍 yfinance<br/>Yahoo Finance 兜底"]
    A --> E["📈 Tushare<br/>深度财务 · Token 鉴权"]

    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:#1e1b4b,stroke:#6366f1,color:#fff
    style F fill:#0f172a,stroke:#334155,color:#fff
    style G fill:#312e81,color:#fff
    style H fill:#312e81,color:#fff
    style I fill:#312e81,color:#fff
    style J fill:#312e81,color:#fff
    style K fill:#312e81,color:#fff
    style L fill:#312e81,color:#fff
    style M fill:#be185d,color:#fff

🎯 全部 31 个 MCP 工具

行情报价

工具	功能	数据源	延迟
`get_realtime_quote`	单股实时行情（现价/涨跌幅/量比/换手率）	easy-tdx → AKShare → yfinance	< 100ms
`batch_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/市值…）
`factor_screener`	五因子综合打分排名（动量·价值·质量·增长·波动）
`analyze_stock`	一站式个股分析报告（行情+技术+财务+综合评分 0-100）
`compare_stocks`	多股横向对比，按评分排名
`correlation_matrix`	收益率相关性矩阵（辅助分散投资）

回测 & 优化

工具	功能	策略
`backtest_strategy`	个股策略回测	双均线·MACD·RSI·KDJ·BOLL·海龟·波动率趋势·均值回归·自定义组合
`optimize_strategy`	网格扫描 / Optuna TPE 贝叶斯优化	自动剪枝 + 参数重要性分析
`walk_forward`	Walk-Forward 样本外验证	滚动训练/测试 · 过拟合评估
`monte_carlo_test`	蒙特卡洛稳健性检验	收益重排 · 概率与回撤分布
`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）
`test_data_sources`	一键诊断所有数据源可用性

🖥️ Web Dashboard

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

mcp-dashboard              # http://localhost:8080
mcp-dashboard 3000         # 指定端口
mcp-dashboard --host 0.0.0.0  # 显式允许局域网访问
# 或双击 start_dashboard.bat（Windows）

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

响应式布局 · Plotly / ECharts 交互图表 · 实时行情自动刷新

🔌 配置 MCP 客户端

Claude Desktop

{
  "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"]
    }
  }
}

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

🧪 测试 & 开发

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-finance

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_markets-0.13.0.tar.gz (139.0 kB view details)

Uploaded Aug 1, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mcp_markets-0.13.0-py3-none-any.whl (131.7 kB view details)

Uploaded Aug 1, 2026 Python 3

File details

Details for the file mcp_markets-0.13.0.tar.gz.

File metadata

Download URL: mcp_markets-0.13.0.tar.gz
Upload date: Aug 1, 2026
Size: 139.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.11.9

File hashes

Hashes for mcp_markets-0.13.0.tar.gz
Algorithm	Hash digest
SHA256	`7b78b03d4d53f95ff92c44f5bd326f8d2825be5620d82e5715108bb842855d36`
MD5	`aa0ba4ad656c4150fcefb0bbb9a406c3`
BLAKE2b-256	`cc91b352e8cd39e09a19d1e00007902c609b9ff2250cd4840755c206864cd581`

See more details on using hashes here.

File details

Details for the file mcp_markets-0.13.0-py3-none-any.whl.

File metadata

Download URL: mcp_markets-0.13.0-py3-none-any.whl
Upload date: Aug 1, 2026
Size: 131.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.11.9

File hashes

Hashes for mcp_markets-0.13.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`4b3daacf21cc10a2c6e1f98e672db4279a09ca981140896aa082eadf7b3cca9e`
MD5	`5f2b3f9cc50fbb41c2674d3edd12cdb9`
BLAKE2b-256	`a10624687e5232a036fa81e4d6ea97cb3822dc7240b5c8cac25ed8ebe8dcffa8`