27dream/mcp-eastmoney

> 🇨🇳 让 Claude / Cursor / Codex 等 MCP 客户端直接查询 A 股实时数据 — 免 API Key、开箱即用
English | 中文
👆 在 Claude Desktop 中直接用自然语言查询 A 股行情和主力资金
---
中文
**mcp-eastmoney** 是基于 Model Context Protocol 的 A 股数据服务器，让 AI 助手能直接调用东方财富的实时行情、主力资金、板块资金流和 K 线数据。
✨ 特性
- 🆓 **完全免费** — 使用东方财富公开延时接口（push2delay.eastmoney.com），无需 API Key
- 🇨🇳 **中文金融场景** — 全 A 股市场覆盖（沪深京），返回结构化中文字段
- ⚡ **5 个核心 Tool** — 实时行情、股票搜索、主力资金排名、板块资金流、历史 K 线
- 🔌 **标准 MCP 协议** — 兼容 Claude Desktop / Cursor / Cline / Continue 等所有 MCP 客户端
- 🐍 **Python + uv** — uvx mcp-eastmoney 一键运行
🛠️ 提供的 Tools
| Tool | 说明 | 示例 |
|------|------|------|
| get_stock_quote | 获取实时行情（价格、涨跌、成交量、PE、换手率） | get_stock_quote(code="300750") |
| search_stock | 按关键词/拼音/代码搜索股票 | search_stock(keyword="宁德") |
| main_fund_rank | 主力资金净流入排名（超大单/大单/中单/小单） | main_fund_rank(market="all", limit=10) |
| sector_fund_flow | 行业/概念板块资金流向 + 领涨股 | sector_fund_flow(kind="industry", limit=10) |
| get_kline | 历史 K 线（日/周/月线，前复权） | get_kline(code="600519", period="daily", count=30) |
🚀 快速开始
1. 通过 uvx 安装（推荐）
2. 通过 pip 安装
3. 接入 Claude Desktop
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：
重启 Claude Desktop，即可看到 5 个新工具。
> 📚 **完整集成教程**：examples/CLAUDE_DESKTOP.md — 含故障排查 + 50+ 实战 prompts (sample_prompts.md)
4. 接入 Cursor
在 Cursor 设置 → MCP 中添加：
💬 使用示例
向 Claude 提问：
> **你**: 帮我看一下宁德时代现在的股价和主力资金情况
> **Claude** *(自动调用 get_stock_quote + main_fund_rank)*:
> 宁德时代（300750）当前 ¥394.85，涨 3.31%，成交 162.79亿。今日主力净流入 19.74亿，居全市场第一，其中超大单净流入 15.04亿，机构资金高度集中…
> **你**: 今天哪些行业板块资金流入最多？
> **Claude** *(调用 sector_fund_flow)*:
> 1. 有色金属：+144.09亿（领涨股 金钼股份 +10.0%）
> 2. 电力设备：+91.76亿（领涨股 宁德时代）
> 3. 工业金属：+83.69亿…
📊 返回数据样例
⚠️ 数据说明
- 数据来源于东方财富**延时**接口（约 15 分钟延迟），仅供研究参考
- 不构成任何投资建议
- 接口由东方财富免费提供，请合理控制请求频率
🤝 贡献
欢迎 PR！计划中的功能：
- [ ] 资金日历、龙虎榜
- [ ] 财务报表数据
- [ ] 北向资金 / 港股 / 美股
- [ ] 技术指标计算（MA/MACD/KDJ）
📜 License
MIT
---
English
**mcp-eastmoney** is an MCP (Model Context Protocol) server that exposes China's A-share stock market data to AI assistants — powered by Eastmoney's free public APIs.
✨ Features
- 🆓 **Zero config** — uses Eastmoney's free delayed-quote endpoints, no API key needed
- 🇨🇳 **A-share native** — covers Shanghai / Shenzhen / Beijing exchanges with proper Chinese fields
- ⚡ **5 core tools** — real-time quotes, stock search, capital flow ranking, sector flow, K-line history
- 🔌 **Standard MCP** — works with Claude Desktop, Cursor, Cline, Continue, and any MCP client
- 🐍 **Python + uv** — one-line install: uvx mcp-eastmoney