FinanceMCP

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

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

[!IMPORTANT]v4.10.0在保留现有 19 个 Tool 名称与参数的前提下，新增按请求凭证裁剪tools/list的能力，并保留 v4.9.0 的 Qveris 路由、自动降级和来源标注。

[!NOTE] 需要在 Trae、Cursor、Claude Code 和 Codex 之间共享模型 Prompt/KV-cache 路由及对话 lineage 时，可选启动独立的finance-cache-gateway。它使用单独的进程、端口和配置；不修改现有 MCP Tool、stdio 或/mcp接口，不启用时现有用法完全不变。

FinanceMCP 已与MarkiNote进行项目联动与融合，形成面向金融研究、AI 分析与智能文档管理场景的一体化系统FinNote。该项目已参加上海市大学生计算机应用能力大赛并获得二等奖。

🌐在线体验：https://finvestai.top/
📝MarkiNote：https://github.com/wink-wink-wink555/MarkiNote

flowchart LR C[AI / MCP Client] -->|现有 19 个 Tools| R{FinanceMCP Router} R -->|默认优先| T[Tushare] R -->|可选扩展| Q[Qveris] R -->|Crypto| B[Binance] R -->|News / Time| L[公开源与本地计算] Q -. 未覆盖 / 超时 / 限流 .-> T T -. 不适用 .-> B T & Q & B & L --> O[来源标注后的统一 MCP 结果]

X-Tushare-Token: YOUR_TUSHARE_TOKEN X-Qveris-Api-Key: YOUR_QVERIS_API_KEY X-Finance-Source-Priority: qveris,tushare,binance

- 只传一种凭证时，优先使用该凭证对应的数据源。
- 同时传入 Tushare 与 Qveris 凭证时，默认 Tushare 优先。
- X-Finance-Source-Priority可按请求调整顺序；未知项忽略、重复项去重、遗漏项按默认顺序补齐。
- 首选数据源接口未覆盖或调用失败时自动降级；正常空结果不会触发重复请求。
- Qveris 内部执行Discover → Inspect → Probe → Call，每次 MCP 请求最多执行一次可能计费的 Call。

数据来源: Tushare 数据源路由: Qveris（接口未覆盖） → Tushare（成功） 原有工具结果……

[!NOTE] Qveris 是可选扩展。未提供X-Qveris-Api-Key/QVERIS_API_KEY时不会调用 Qveris，也不会消耗 credits。接口契约参见Qveris REST API。

tools/list会根据当前 MCP 请求实际携带的凭证裁剪工具目录：只传 Qveris Key 时只展示 Qveris adapter 覆盖的现有 Tools，只传 Tushare Token 时只展示 Tushare 覆盖的 Tools；同时传入两者时展示两者的并集。没有凭证时仅展示公共数据源与本地工具。tools/call也执行相同校验，避免 AI 调用到当前请求无法使用的数据源。
- 在Tushare注册并登录。
- 进入个人中心 → 账号与 TOKEN，复制 Token；完整步骤见官方 Token 指南。
- 将 Token 写入本地TUSHARE_TOKEN，或在远程 MCP 请求中通过X-Tushare-Token传递。

[!TIP] 🎓Tushare 高校学生认证可免费获得 2000 积分。当前官方流程要求完善学校和个人资料、加入高校用户群，并向管理员提交学生证或学信网截图及 Tushare ID。入口与最新步骤见学生免费积分获取。Tushare 服务协议同时说明，高校学生和教师完成身份确认后分别可获得2000 / 5000 积分权限。不同接口的积分门槛与频次不同，请以对应接口文档和积分权限页面为准。
- 登录Qveris，打开Dashboard / API Keys。
- 创建并复制 API Key。Qveris 当前为新账号提供 1000 credits；Discover、Inspect 免费，实际 Call 可能按能力计费。
- 将 Key 写入本地QVERIS_API_KEY，或在远程 MCP 请求中通过独立的X-Qveris-Api-Key传递。

[!WARNING] 不要把真实 Token / API Key 写进 README、MCP 配置示例或提交到 Git。推荐使用.env、客户端环境变量或每次 HTTP 请求的 Header。

{ "mcpServers": { "finance-mcp": { "command": "npx", "args": ["-y", "finance-mcp"], "env": { "TUSHARE_TOKEN": "YOUR_TUSHARE_TOKEN", "QVERIS_API_KEY": "YOUR_QVERIS_API_KEY", "FINANCE_SOURCE_PRIORITY": "tushare,qveris,binance" } } } }

{ "mcpServers": { "finance-mcp": { "type": "streamableHttp", "url": "https://finvestai.top/mcp", "timeout": 600, "headers": { "X-Tushare-Token": "YOUR_TUSHARE_TOKEN", "X-Qveris-Api-Key": "YOUR_QVERIS_API_KEY", "X-Finance-Source-Priority": "qveris,tushare,binance" } } } }

两个 Key 都是可选的，可以只传其中一个。Authorization: Bearer ...与X-Api-Key继续兼容为 Tushare Token；Qveris 使用独立的X-Qveris-Api-Key。

Qveris*是动态数据能力路由层，会按查询自动选择已接入的实际接口商（例如 Finnhub、Tiingo 等）；最终选中的接口商、能力 ID 与数据来源会随 Tool 结果一起返回。未标记 Qveris 的 Tool 会明确返回“接口未覆盖”，再降级到表内原生数据源。

macd(12,26,9) rsi(14) kdj(9,3,3) boll(20,2) ma(5) ma(10) ma(20)

stock_data会自动预取指标所需的额外历史数据，计算完成后再裁剪到用户请求区间。带技术指标的请求保持使用原生数据源，确保既有计算与展示格式稳定。

git clone https://github.com/guangxiangdebizi/FinanceMCP.git cd FinanceMCP cp .env.example .env npm ci npm test

npm run start:stdio # stdio npm run start:http # http://127.0.0.1:3000/mcp

node_modules/与build/是本地生成物，不纳入 Git 跟踪。npm 发布时会通过prepare自动构建，仅打包运行所需的build/。

- API Key 仅从请求 Header 或环境变量读取，不写入仓库。
- HTTP 请求凭证按请求隔离，敏感 Header 在日志中显示为[REDACTED]。
- QVERIS_BASE_URL默认强制 HTTPS；仅 loopback 地址允许 HTTP 回归测试。
- Qveris 候选能力经过只读过滤、参数 Probe、响应大小限制与超时控制。
- .env、依赖目录、构建产物、日志和本地研究资料均由 Git ignore 规则管理。

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

- FinanceMCP 可作为FinNote / MarkiNote的金融数据后端。
- 在线体验：finvestai.top
- MCP 生态收录：Glama·Smithery·MCP Toplist
- 视频教程：FinanceMCP 完整使用指南
- Bug 与功能建议：GitHub Issues

62 real-time data tools for AI agents via MCP. Finance, crypto, FMCSA, sanctions, courts, weather, vehicles, cybersecurity. One bearer token, one bill. Free tier available.