guangxiangdebizi/FinanceMCP

为 AI Agent 提供统一、可路由、可追溯的多市场金融数据
19 个稳定 MCP Tools · Tushare / Qveris / Binance · stdio + Streamable HTTP
快速开始 ·
数据源路由 ·
API 获取 ·
Tools ·
安全 ·
Star 趋势 ·
English
> [!WARNING]
> 服务状态：公网托管服务暂时停止。 原公网域名已经到期，当前不提供官方在线体验或托管 /mcp Endpoint；后续可能更换域名，恢复时间与新地址将通过本仓库公告。npm 包、本地 stdio 使用和自行部署不受影响。
> [!IMPORTANT]
> v4.11.2 加固 Twingly 新闻路由的参数校验、请求大小限制、数据源回退和动态 Tool Schema，并补充敏感请求头脱敏。现有 19 个 Tool 名称与主要调用方式保持不变。
> [!NOTE]
> 需要在 Trae、Cursor、Claude Code 和 Codex 之间共享模型 Prompt/KV-cache 路由及对话 lineage 时，可选启动独立的 finance-cache-gateway。它使用单独的进程、端口和配置；不修改现有 MCP Tool、stdio 或 /mcp 接口，不启用时现有用法完全不变。
## 🔗 项目联动：FinNote 智能金融文档系统
FinanceMCP 已与 MarkiNote 进行项目联动与融合，形成面向金融研究、AI 分析与智能文档管理场景的一体化系统 FinNote。该项目已参加上海市大学生计算机应用能力大赛并获得二等奖。
🌐 在线体验：暂时停止，后续可能更换域名
📝 MarkiNote：https://github.com/wink-wink-wink555/MarkiNote
在 FinNote 的整体架构中，FinanceMCP 作为核心的 金融数据与 MCP 工具服务层，基于 Node.js、Express 与 Model Context Protocol（MCP）SDK 构建。目前通过 19 个稳定的 MCP 工具，为 AI Agent 提供股票、基金、债券、宏观经济、财经新闻、技术指标以及多市场行情等金融数据能力，并支持 stdio 与 Streamable HTTP 两种接入方式。
MarkiNote 则作为上层 AI Agent 智能文档与知识管理系统，负责承载自然语言交互、AI 分析结果展示、Markdown 文档生成、编辑与长期知识沉淀。在 FinNote 场景中，MarkiNote 通过 HTTP / MCP 服务链路调用 FinanceMCP，使金融数据能力能够直接进入 AI Agent 的推理与文档工作流。
整体流程形成：
自然语言提问 → AI Agent 任务理解 → FinanceMCP 工具调用 → 多源金融数据获取 → AI 智能分析 → Markdown 文档生成 → 文档管理与知识沉淀
因此，FinanceMCP 不仅可以作为独立的金融数据 MCP Server 接入 Claude、Cursor、Codex 等 MCP Client 或 AI Agent，也可以作为 FinNote 等上层 AI 应用的金融数据基础设施，为智能投研、金融分析和文档型 Agent 提供统一、结构化、可调用且可追溯的数据能力。
## ✨ 核心亮点
| | 能力 | 说明 |
| 🔌 | 无侵入式扩展 | 保持现有 19 个 Tool 名称和参数，数据源选择由请求上下文完成 |
| 🧭 | 智能路由 | 同时支持 Tushare、Qveris、Binance 与公开新闻源 |
| 🔁 | 自动降级 | 首选来源未覆盖、超时、限流或不可用时按优先级继续尝试 |
| 🏷️ | 来源透明 | 每次返回都标注实际数据来源；发生降级时同时返回完整路由 |
| 🛡️ | 请求级隔离 | HTTP Key 通过 AsyncLocalStorage 隔离，日志统一脱敏 |
| 📈 | 多市场覆盖 | A 股、港股、美股、指数、基金、债券、期货、外汇、宏观与加密资产 |
| 🧮 | 技术指标引擎 | MACD、RSI、KDJ、BOLL、MA 自动扩展历史窗口后再计算 |
| 🚀 | 双传输模式 | 同时支持本地 stdio 与远程 Streamable HTTP |
## 🧭 数据源路由
mermaid
flowchart LR
C[AI / MCP Client] -->|现有 19 个 Tools| R{FinanceMCP Router}
R -->|默认优先| T[Tushare]
R -->|全球新闻| G[Twingly]
R -->|可选扩展| Q[Qveris]
R -->|Crypto| B[Binance]
R -->|News / Time| L[公开源与本地计算]
Q -. 未覆盖 / 超时 / 限流 .-> T
T -. 不适用 .-> B
T & G & Q & B & L --> O[来源标注后的统一 MCP 结果]
### HTTP 请求头
http
X-Tushare-Token: YOUR_TUSHARE_TOKEN
X-Qveris-Api-Key: YOUR_QVERIS_API_KEY
X-Twingly-Api-Key: YOUR_TWINGLY_API_KEY
X-Finance-Source-Priority: twingly,qveris,tushare,binance
默认优先级：
text
tushare,twingly,qveris,binance
路由行为：
1. 只传一种凭证时，优先使用该凭证对应的数据源。
2. 同时传入多种凭证时，默认 Tushare 优先；新闻工具随后尝试 Twingly，再尝试 Qveris 与公共源。
3. X-Finance-Source-Priority 可按请求调整顺序；未知项忽略、重复项去重、遗漏项按默认顺序补齐。
4. 首选数据源接口未覆盖或调用失败时自动降级；正常空结果不会触发重复请求。
5. Qveris 内部执行 Discover → Inspect → Probe → Call，每次 MCP 请求最多执行一次可能计费的 Call。
返回示例：
text
数据来源: Tushare
数据源路由: Qveris（接口未覆盖） → Tushare（成功）
原有工具结果……
> [!NOTE]
> Qveris 是可选扩展。未提供 X-Qveris-Api-Key / QVERIS_API_KEY 时不会调用 Qveris，也不会消耗 credits。接口契约参见 Qveris REST API。
> [!NOTE]
> Twingly 是可选的全球新闻源。未提供 X-Twingly-Api-Key / TWINGLY_API_KEY 时不会调用。FinanceMCP 只返回标题、来源、时间、文章与站点标识、URL、语言/地区、栏目和去重元数据，不返回或持久化文章全文。
### 按凭证动态显示 Tools
tools/list 会根据当前 MCP 请求实际携带的凭证裁剪工具目录：只传 Twingly Key 时展示两个现有新闻 Tools，只传 Qveris Key 时只展示 Qveris adapter 覆盖的现有 Tools，只传 Tushare Token 时只展示 Tushare 覆盖的 Tools；同时传入多种凭证时展示并集。没有凭证时仅展示公共数据源与本地工具。tools/call 也执行相同校验，避免 AI 调用到当前请求无法使用的数据源。