{"id":"ef5efcb3-d3e1-4bf0-bdd4-914398543956","slug":"financemcp","kind":"mcp","name":"FinanceMCP","summary":"这是一个金融领域相关的mcp,本项目通过集成 Tushare API 和 Binance API 为语言模型（如Claude）提供全面的实时金融数据访问能力，支持股票、基金、债券、宏观经济指标、稳定币、虚拟货币等多维度金融数据分析。其中也包含了金融数据查询、财经新闻查询、国家统计局数据查询等","owner":"guangxiangdebizi","repoUrl":"https://github.com/guangxiangdebizi/FinanceMCP","license":"MIT","licenseTier":"permissive","trust":"community","stars":862,"match":null,"fewStars":false,"format":"mcp","createdAt":"2025-05-10T01:55:53.000Z","addedAt":"2026-10-14T03:42:09.385Z","logoUrl":"https://avatars.githubusercontent.com/u/154864206?u=242861437f861665e252c22ac6d1dc7a5c9c4015&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["data-analytics","cloud-infra"],"tags":["data","finance","llm","news","tushare","binance","stablecoin"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-15T02:31:39.392Z","sample":false,"url":"https://conduits.dev/tools/financemcp","language":"TypeScript","transports":["stdio"],"install":{"npm":"finance-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"
\n \n \"FinanceMCP\n \n\n

FinanceMCP Synapse

\n\n

为 AI Agent 提供统一、可路由、可追溯的多市场金融数据

\n

19 个稳定 MCP Tools · Tushare / Qveris / Binance · stdio + Streamable HTTP

\n\n

\n \"npm\n \"npm\n \"GitHub\n \"GitHub\n \"MIT\n \"Node.js\n

\n\n

\n \"FinanceMCP\n \"FinanceMCP\n

\n\n

\n 快速开始 ·\n 数据源路由 ·\n API 获取 ·\n Tools ·\n 安全 ·\n Star 趋势 ·\n English\n

\n
\n\n> [!WARNING]\n> **服务状态：公网托管服务暂时停止。** 原公网域名已经到期，当前不提供官方在线体验或托管 `/mcp` Endpoint；后续可能更换域名，恢复时间与新地址将通过本仓库公告。npm 包、本地 stdio 使用和自行部署不受影响。\n\n> [!IMPORTANT]\n> **v4.11.2** 加固 Twingly 新闻路由的参数校验、请求大小限制、数据源回退和动态 Tool Schema，并补充敏感请求头脱敏。现有 19 个 Tool 名称与主要调用方式保持不变。\n\n> [!NOTE]\n> 需要在 Trae、Cursor、Claude Code 和 Codex 之间共享模型 Prompt/KV-cache 路由及对话 lineage 时，可选启动独立的 [`finance-cache-gateway`](./docs/cache-gateway.md)。它使用单独的进程、端口和配置；不修改现有 MCP Tool、stdio 或 `/mcp` 接口，不启用时现有用法完全不变。\n\n## 🔗 项目联动：FinNote 智能金融文档系统\n\nFinanceMCP 已与 [MarkiNote](https://github.com/wink-wink-wink555/MarkiNote) 进行项目联动与融合，形成面向金融研究、AI 分析与智能文档管理场景的一体化系统 **FinNote**。该项目已参加上海市大学生计算机应用能力大赛并获得二等奖。\n\n🌐 **在线体验：暂时停止，后续可能更换域名**\n📝 **MarkiNote：[https://github.com/wink-wink-wink555/MarkiNote](https://github.com/wink-wink-wink555/MarkiNote)**\n\n在 FinNote 的整体架构中，FinanceMCP 作为核心的 **金融数据与 MCP 工具服务层**，基于 Node.js、Express 与 Model Context Protocol（MCP）SDK 构建。目前通过 19 个稳定的 MCP 工具，为 AI Agent 提供股票、基金、债券、宏观经济、财经新闻、技术指标以及多市场行情等金融数据能力，并支持 stdio 与 Streamable HTTP 两种接入方式。\n\nMarkiNote 则作为上层 **AI Agent 智能文档与知识管理系统**，负责承载自然语言交互、AI 分析结果展示、Markdown 文档生成、编辑与长期知识沉淀。在 FinNote 场景中，MarkiNote 通过 HTTP / MCP 服务链路调用 FinanceMCP，使金融数据能力能够直接进入 AI Agent 的推理与文档工作流。\n\n整体流程形成：\n\n**自然语言提问 → AI Agent 任务理解 → FinanceMCP 工具调用 → 多源金融数据获取 → AI 智能分析 → Markdown 文档生成 → 文档管理与知识沉淀**\n\n因此，FinanceMCP 不仅可以作为独立的金融数据 MCP Server 接入 Claude、Cursor、Codex 等 MCP Client 或 AI Agent，也可以作为 FinNote 等上层 AI 应用的金融数据基础设施，为智能投研、金融分析和文档型 Agent 提供统一、结构化、可调用且可追溯的数据能力。\n\n## ✨ 核心亮点\n\n| | 能力 | 说明 |\n|---|---|---|\n| 🔌 | **无侵入式扩展** | 保持现有 19 个 Tool 名称和参数，数据源选择由请求上下文完成 |\n| 🧭 | **智能路由** | 同时支持 Tushare、Qveris、Binance 与公开新闻源 |\n| 🔁 | **自动降级** | 首选来源未覆盖、超时、限流或不可用时按优先级继续尝试 |\n| 🏷️ | **来源透明** | 每次返回都标注实际数据来源；发生降级时同时返回完整路由 |\n| 🛡️ | **请求级隔离** | HTTP Key 通过 AsyncLocalStorage 隔离，日志统一脱敏 |\n| 📈 | **多市场覆盖** | A 股、港股、美股、指数、基金、债券、期货、外汇、宏观与加密资产 |\n| 🧮 | **技术指标引擎** | MACD、RSI、KDJ、BOLL、MA 自动扩展历史窗口后再计算 |\n| 🚀 | **双传输模式** | 同时支持本地 stdio 与远程 Streamable HTTP |\n\n\n\n## 🧭 数据源路由\n\n```mermaid\nflowchart LR\n C[AI / MCP Client] -->|现有 19 个 Tools| R{FinanceMCP Router}\n R -->|默认优先| T[Tushare]\n R -->|全球新闻| G[Twingly]\n R -->|可选扩展| Q[Qveris]\n R -->|Crypto| B[Binance]\n R -->|News / Time| L[公开源与本地计算]\n Q -. 未覆盖 / 超时 / 限流 .-> T\n T -. 不适用 .-> B\n T & G & Q & B & L --> O[来源标注后的统一 MCP 结果]\n```\n\n### HTTP 请求头\n\n```http\nX-Tushare-Token: YOUR_TUSHARE_TOKEN\nX-Qveris-Api-Key: YOUR_QVERIS_API_KEY\nX-Twingly-Api-Key: YOUR_TWINGLY_API_KEY\nX-Finance-Source-Priority: twingly,qveris,tushare,binance\n```\n\n默认优先级：\n\n```text\ntushare,twingly,qveris,binance\n```\n\n路由行为：\n\n1. 只传一种凭证时，优先使用该凭证对应的数据源。\n2. 同时传入多种凭证时，默认 Tushare 优先；新闻工具随后尝试 Twingly，再尝试 Qveris 与公共源。\n3. `X-Finance-Source-Priority` 可按请求调整顺序；未知项忽略、重复项去重、遗漏项按默认顺序补齐。\n4. 首选数据源接口未覆盖或调用失败时自动降级；正常空结果不会触发重复请求。\n5. Qveris 内部执行 **Discover → Inspect → Probe → Call**，每次 MCP 请求最多执行一次可能计费的 Call。\n\n返回示例：\n\n```text\n数据来源: Tushare\n数据源路由: Qveris（接口未覆盖） → Tushare（成功）\n\n原有工具结果……\n```\n\n> [!NOTE]\n> Qveris 是可选扩展。未提供 `X-Qveris-Api-Key` / `QVERIS_API_KEY` 时不会调用 Qveris，也不会消耗 credits。接口契约参见 [Qveris REST API](https://qveris.ai/docs/rest-api)。\n\n> [!NOTE]\n> Twingly 是可选的全球新闻源。未提供 `X-Twingly-Api-Key` / `TWINGLY_API_KEY` 时不会调用。FinanceMCP 只返回标题、来源、时间、文章与站点标识、URL、语言/地区、栏目和去重元数据，不返回或持久化文章全文。\n\n### 按凭证动态显示 Tools\n\n`tools/list` 会根据当前 MCP 请求实际携带的凭证裁剪工具目录：只传 Twingly Key 时展示两个现有新闻 Tools，只传 Qveris Key 时只展示 Qveris adapter 覆盖的现有 Tools，只传 Tushare Token 时只展示 Tushare 覆盖的 Tools；同时传入多种凭证时展示并集。没有凭证时仅展示公共数据源与本地工具。`tools/call` 也执行相同校验，避免 AI 调用到当前请求无法使用的数据源。\n\n\n\n## 🔑 数据源与 API 获取\n\n| 数据源 | 是否需要凭证 | 官方获取入口 | FinanceMCP 配置 |\n|---|---|---|---|\n| **Tushare Pro** | 需要 Token | [注册账号](https://tushare.pro/document/1?doc_id=38) · [获取 Token](https://tushare.pro/document/1?doc_id=39) | stdio：`TUSHARE_TOKEN`；HTTP：`X-Tushare-Token` |\n| **Qveris** | 需要 API Key | [Dashboard / API Keys](https://qveris.ai/account?page=api-keys) · [官方文档](https://qveris.ai/docs) | stdio：`QVERIS_API_KEY`；HTTP：`X-Qveris-Api-Key` |\n| **Twingly News Search** | 需要 API Key | [Dashboard / API Key](https://app.twingly.com/) · [News API](https://www.twingly.com/news-api/) | stdio：`TWINGLY_API_KEY`；HTTP：`X-Twingly-Api-Key` |\n| **Binance Public API** | **不需要** | [Spot REST API 文档](https://developers.binance.com/docs/binance-spot-api-docs/rest-api) | 无需配置；加密资产行情自动使用公开接口 |\n| **百度新闻** | **不需要** | 无需申请 API | 无需配置；`finance_news` 使用公开新闻检索 |\n| **本地系统时钟** | **不需要** | 无 | 无需配置；仅供 `current_timestamp` 使用 |\n\n### Tushare Token\n\n1. 在 [Tushare](https://tushare.pro/) 注册并登录。\n2. 进入 **个人中心 → 账号与 TOKEN**，复制 Token；完整步骤见 [官方 Token 指南](https://tushare.pro/document/1?doc_id=39)。\n3. 将 Token 写入本地 `TUSHARE_TOKEN`，或在远程 MCP 请求中通过 `X-Tushare-Token` 传递。\n\n> [!TIP]\n> 🎓 **Tushare 高校学生认证可免费获得 2000 积分。** 当前官方流程要求完善学校和个人资料、加入高校用户群，并向管理员提交学生证或学信网截图及 Tushare ID。入口与最新步骤见 [学生免费积分获取](https://tushare.pro/document/1?doc_id=360)。Tushare 服务协议同时说明，高校学生和教师完成身份确认后分别可获得 **2000 / 5000 积分**权限。不同接口的积分门槛与频次不同，请以对应接口文档和[积分权限页面](https://tushare.pro/weborder/#/permission)为准。\n\n### Qveris API Key\n\n1. 登录 [Qveris](https://qveris.ai/)，打开 [Dashboard / API Keys](https://qveris.ai/account?page=api-keys)。\n2. 创建并复制 API Key。Qveris 当前为新账号提供 1000 credits；Discover、Inspect 免费，实际 Call 可能按能力计费。\n3. 将 Key 写入本地 `QVERIS_API_KEY`，或在远程 MCP 请求中通过独立的 `X-Qveris-Api-Key` 传递。\n\n### Twingly API Key\n\n1. 登录 [Twingly Dashboard](https://app.twingly.com/)，从右上角复制 API Key 并确认剩余额度。\n2. 将 Key 写入本地 `TWINGLY_API_KEY`，或在远程 MCP 请求中通过独立的 `X-Twingly-Api-Key` 传递。\n3. Twingly 仅作为 `finance_news` 与 `hot_news_7x24` 的可选上游；认证失败、限流、服务异常或无匹配结果时按配置自动回退。调用方参数校验失败不会回退到语义不同的新闻源。\n4. `finance_news` 默认把空格分隔的内容作为多个必含词；需要精确短语时使用双引号，例如 `\"Federal Reserve\" inflation`。Twingly 最多接受 250 个组合词项，请求正文最多 16 KiB（按 UTF-8 字节计）；超出任一限制都会在发送上游请求前明确报错。\n5. Twingly 单次最多返回 250 条新闻。`tools/list` 在 Twingly 是当前首选新闻源时会把 `hot_news_7x24.limit` 的 schema 上限设为 250；其他数据源可继续公布自身上限。\n\n### 无 Key 数据源\n\n- **Binance**：FinanceMCP 当前只调用安全类型为 `NONE` 的公开 K 线接口，不需要 Binance 账号、API Key 或交易权限。\n- **百度新闻**：使用公开新闻搜索，不需要开发者凭证；若网络或上游检索不可用，可按配置的优先级尝试 Qveris 新闻能力。\n\n> [!WARNING]\n> 不要把真实 Token / API Key 写进 README、MCP 配置示例或提交到 Git。推荐使用 `.env`、客户端环境变量或每次 HTTP 请求的 Header。\n\n\n\n## 🚀 快速开始\n\n### npm / stdio\n\n```bash\nnpx -y finance-mcp\n```\n\nClaude Desktop、Cursor 等本地 MCP 客户端配置：\n\n```json\n{\n \"mcpServers\": {\n \"finance-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"finance-mcp\"],\n \"env\": {\n \"TUSHARE_TOKEN\": \"YOUR_TUSHARE_TOKEN\",\n \"QVERIS_API_KEY\": \"YOUR_QVERIS_API_KEY\",\n \"TWINGLY_API_KEY\": \"YOUR_TWINGLY_API_KEY\",\n \"FINANCE_SOURCE_PRIORITY\": \"tushare,twingly,qveris,binance\"\n }\n }\n }\n}\n```\n\n### Streamable HTTP\n\n公网托管 Endpoint 当前暂停。新域名确认前，请使用上面的本地 stdio 配置，或自行部署 Streamable HTTP 服务：\n\n```json\n{\n \"mcpServers\": {\n \"finance-mcp\": {\n \"type\": \"streamableHttp\",\n \"url\": \"https://your-finance-mcp.example/mcp\",\n \"timeout\": 600,\n \"headers\": {\n \"X-Tushare-Token\": \"YOUR_TUSHARE_TOKEN\",\n \"X-Qveris-Api-Key\": \"YOUR_QVERIS_API_KEY\",\n \"X-Twingly-Api-Key\": \"YOUR_TWINGLY_API_KEY\",\n \"X-Finance-Source-Priority\": \"twingly,qveris,tushare,binance\"\n }\n }\n }\n}\n```\n\n三个凭证都是可选的，可以只传其中一个。`Authorization: Bearer ...` 与 `X-Api-Key` 继续兼容为 Tushare Token；Qveris 与 Twingly 使用各自的独立 Header。\n\n
\n环境变量\n\n| 变量 | 默认值 | 说明 |\n|---|---|---|\n| `TUSHARE_TOKEN` | 空 | Tushare 凭证 |\n| `QVERIS_API_KEY` | 空 | Qveris 凭证 |\n| `QVERIS_BASE_URL` | `https://qveris.ai/api/v1` | Qveris REST API 地址 |\n| `TWINGLY_API_KEY` | 空 | Twingly News Search 凭证 |\n| `TWINGLY_BASE_URL` | `https://data.twingly.net/news/b/search/v1/search` | Twingly News Search API 地址 |\n| `FINANCE_SOURCE_PRIORITY` | `tushare,twingly,qveris,binance` | stdio 或服务端默认优先级 |\n| `PORT` | `3000` | HTTP 服务端口 |\n| `MCP_HTTP_HOST` | `127.0.0.1` | HTTP 监听地址；容器部署使用 `0.0.0.0` |\n| `MCP_ALLOWED_HOSTS` | 回环地址白名单 | 逗号分隔的 Host 主机名白名单（不含端口）；非回环部署建议显式配置 |\n\n
\n\n#### 自建远程实例（可选）\n\n当前不提供官方在线 Endpoint。如果你需要一个独立的 `/mcp` 地址，仓库根目录的\n`Dockerfile` 可以直接部署：启动命令是 `node build/httpServer.js`，监听 `0.0.0.0`，\n从环境变量读取 `PORT`，并提供 `GET /health`。后续若启用新的官方域名，将在本仓库公告。\n\n[docs/deploy-dockhold.md](docs/deploy-dockhold.md) 以 [Dockhold](https://dockhold.eu)\n为例（只是其中一种托管方式，并非关联或推荐平台），说明 HTTPS 端点、`TUSHARE_TOKEN`\n与 `QVERIS_API_KEY` 的存放位置，以及为什么在公网可访问时强烈建议设置\n`MCP_ALLOWED_HOSTS`。\n\n\n\n## 🧰 19 个 MCP Tools\n\n| Tool | 功能 | 数据源 / 接口商 |\n|---|---|---|\n| `current_timestamp` | UTC+8 当前时间戳 | 本地系统时钟 |\n| `finance_news` | 财经新闻关键词检索 | Twingly* · 百度新闻 · Qveris* |\n| `stock_data` | 多市场历史行情与技术指标 | Tushare Pro · Qveris* · Binance Public API（加密资产） |\n| `stock_data_minutes` | A 股与加密资产分钟 K 线 | Tushare Pro · Qveris* · Binance Public API（加密资产） |\n| `index_data` | 指数行情、基本信息与估值 | Tushare Pro · Qveris* |\n| `macro_econ` | GDP、CPI、PPI、PMI、Shibor、LPR、Libor、Hibor 等 | Tushare Pro · Qveris* |\n| `company_performance` | A 股公司、财务、分红、股东与估值数据 | Tushare Pro · Qveris* |\n| `company_performance_hk` | 港股利润表、资产负债表与现金流量表 | Tushare Pro · Qveris* |\n| `company_performance_us` | 美股财务报表与指标 | Tushare Pro · Qveris* |\n| `fund_data` | 基金净值、持仓、分红与基础资料 | Tushare Pro |\n| `fund_manager_by_name` | 基金经理及管理基金查询 | Tushare Pro |\n| `convertible_bond` | 可转债全生命周期数据 | Tushare Pro |\n| `block_trade` | 大宗交易明细 | Tushare Pro |\n| `money_flow` | 个股、大盘、行业与互联互通资金流 | Tushare Pro |\n| `margin_trade` | 融资融券与转融券数据 | Tushare Pro |\n| `csi_index_constituents` | CSI 指数表现、成分权重与财务摘要 | Tushare Pro · Qveris* |\n| `dragon_tiger_inst` | 龙虎榜机构交易明细 | Tushare Pro |\n| `hot_news_7x24` | 7×24 财经热点与内容去重 | Tushare Pro · Twingly* · Qveris* |\n| `futures_data` | 期货会员持仓排名 | Tushare Pro |\n\n> **Qveris\\*** 是动态数据能力路由层，会按查询自动选择已接入的实际接口商（例如 Finnhub、Tiingo 等）；最终选中的接口商、能力 ID 与数据来源会随 Tool 结果一起返回。未标记 Qveris 的 Tool 会明确返回“接口未覆盖”，再降级到表内原生数据源。\n\n## 📊 技术指标\n\n```text\nmacd(12,26,9) rsi(14) kdj(9,3,3) boll(20,2) ma(5) ma(10) ma(20)\n```\n\n`stock_data` 会自动预取指标所需的额外历史数据，计算完成后再裁剪到用户请求区间。带技术指标的请求保持使用原生数据源，确保既有计算与展示格式稳定。\n\n## 🛠️ 本地开发\n\n```bash\ngit clone https://github.com/guangxiangdebizi/FinanceMCP.git\ncd FinanceMCP\ncp .env.example .env\nnpm ci\nnpm test\n```\n\n```bash\nnpm run start:stdio # stdio\nnpm run start:http # http://127.0.0.1:3000/mcp\n```\n\n`node_modules/` 与 `build/` 是本地生成物，不纳入 Git 跟踪。npm 发布时会通过 `prepare` 自动构建，仅打包运行所需的 `build/`。\n\n\n\n## 🛡️ 安全设计\n\n- API Key 仅从请求 Header 或环境变量读取，不写入仓库。\n- HTTP 请求凭证按请求隔离，敏感 Header 在日志中显示为 `[REDACTED]`。\n- `QVERIS_BASE_URL` 默认强制 HTTPS；仅 loopback 地址允许 HTTP 回归测试。\n- Qveris 候选能力经过只读过滤、参数 Probe、响应大小限制与超时控制。\n- `.env`、依赖目录、构建产物、日志和本地研究资料均由 Git ignore 规则管理。\n\n\n\n## ⭐ Star 趋势\n\n

\n \n \"FinanceMCP\n \n

\n\n如果 FinanceMCP 对你有帮助，欢迎点一个 ⭐。趋势图由仓库自己的 GitHub Actions 每周一自动更新，也支持手动刷新；使用仓库临时 `GITHUB_TOKEN`，不依赖第三方 Star 抓取服务或长期凭证。\n\n## 🤝 生态与贡献\n\n

\n \n \"FinanceMCP\n \n

\n\n- FinanceMCP 可作为 [FinNote / MarkiNote](https://github.com/wink-wink-wink555/MarkiNote) 的金融数据后端。\n- 在线体验：公网托管服务暂时停止，后续可能更换域名\n- MCP 生态收录：[Glama](https://glama.ai/mcp/servers/@guangxiangdebizi/my-mcp-server) · [Smithery](https://smithery.ai/servers/@guangxiangdebizi/FinanceMCP) · [MCP Toplist](https://mcptoplist.com/server/pulsemcp%2Fguangxiangdebizi-finance-market-data)\n- 视频教程：[FinanceMCP 完整使用指南](https://www.bilibili.com/video/BV1qeNnzEEQi/)\n- Bug 与功能建议：[GitHub Issues](https://github.com/guangxiangdebizi/FinanceMCP/issues)\n\n欢迎提交 Issue 或 Pull Request。新增数据能力时优先兼容现有聚合 Tool，避免一接口一 Tool 的表面扩张。\n\n## 📄 License\n\n[MIT](LICENSE)\n"}