Finmcp Finance Mcp

Yahoo Finance MCP 服务（云端）

面向 AI 助手的生产级（云端）金融数据基础设施，具备企业级韧性、全面的数据质量验证和可用于生产环境的监控能力。

部署到云端（基于 Docker）

FinMCP 内置 Dockerfile，完全基于 Docker 构建，因此可在任何支持容器的平台上运行——Railway、Render、Fly.io、DigitalOcean App Platform、VPS，或其他平台。

最简单的选项——Railway（推荐新手使用）：

1. 在 railway.com 注册 (推荐链接——可获得免费额度)
2. 新建项目 → 从 GitHub 仓库部署 → 粘贴 https://github.com/Steve-sy/finmcp
3. Railway 会自动检测 Dockerfile，并自动构建和部署
4. (可选) 在 Railway 的 Variables 标签页中添加 YF_MCP_API_KEY，以保护你的端点
5. 前往 Settings → Networking → Generate Domain 获取公开 URL
6. 你的 MCP 端点现已上线，地址为：https://<your-app>.up.railway.app/mcp

其他平台（Render、Fly.io、VPS 等）：

任何可以运行 Docker 容器的平台都适用。将此仓库指定为源，并将启动命令设为 node dist/http.js。服务会监听 PORT 环境变量（大多数平台会自动注入），默认值为 3333。

可选：使用 YF_MCP_API_KEY 保护公开部署，并通过 ...?key=YOUR_SECRET 连接。

Claude Desktop 集成（云端）

自定义 → 连接器 → 添加自定义连接器： 名称：FinMCP 远程 MCP 服务 URL：你的云端 https URL：https:///mcp

---

本地安装

npm install -g @mustafa.ramx/finmcp

快速开始

启动服务

finmcp

Claude Desktop 集成（本地 — npm）

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "finmcp": {
      "command": "finmcp"
    }
  }
}

Claude Desktop 集成（本地 — Docker）

如果你更愿意使用 Docker 而不是安装 Node.js，请先构建镜像：

docker build -t finmcp .

然后将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "finmcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "finmcp", "node", "dist/index.js"]
    }
  }
}

注意： ChatGPT Desktop 对 MCP 的支持可能有所不同——请查阅其文档，了解自定义连接器的配置方法。

其他 AI 工具

Cursor AI / Cline AI：

{
  "mcpServers": {
    "finmcp": {
      "command": "finmcp"
    }
  }
}

功能

• 15 种金融数据工具：股票、期权、加密货币、外汇、公司情报、市场情绪
• 熔断器模式：从 API 故障中自动恢复
• 多策略速率限制：令牌桶 + 自适应 + 按端点限制
• 数据质量评分：完整性和可靠性验证
• 全面缓存：提供平稳的回退机制，并保持较高的缓存命中率（70-90%）
• 流式 HTTP 传输：可在本地运行，或部署到云端（Docker/Railway）以通过 HTTPS 访问
• 可选 API 密钥身份验证：使用 YF_MCP_API_KEY 保护公开部署
• 企业级测试：单元测试、集成测试、端到端测试和混沌测试

可用工具

市场数据

• get_quote - 提供实时行情及质量报告
• get_historical_prices - 提供指定日期范围内的 OHLCV 数据
• get_historical_prices_multi - 批量获取历史数据

公司情报

• get_quote_summary - 全面的公司概览
• get_balance_sheet - 资产、负债和股东权益
• get_income_statement - 营收、支出和净利润
• get_cash_flow_statement - 经营、投资和融资现金流
• get_earnings - 包含预估值的季度财报
• get_analysis - 分析师建议和目标价
• get_major_holders - 机构和内部人士持股情况

市场情绪

• get_news - 包含相关性评分的最新文章
• get_options - 包含希腊值的期权链
• get_trending_symbols - 按交易量指标列出的涨幅和跌幅榜
• screener - 根据 12 项以上的条件筛选股票

跨资产

• get_crypto_quote - 加密货币价格
• get_forex_quote - 货币对汇率

文档

如需查看包含配置、使用示例、架构详情和最佳实践的完整文档：

在 GitHub 上查看完整文档

文档包括：

• 完整工具参考
• 附示例的使用指南
• 配置指南
• 架构详情
• 数据验证状态

配置

创建一个 config.json 文件：

{
  "rateLimit": {
    "requestsPerMinute": 60,
    "requestsPerHour": 1500
  },
  "cache": {
    "ttlQuotes": 60000,
    "maxCacheSize": 1000
  },
  "circuitBreaker": {
    "failureThreshold": 5,
    "monitoringWindow": 60000,
    "successThreshold": 3
  }
}

有关详细配置选项，请参阅配置指南。

性能

指标	数值
报价查询	每分钟 60 次请求（可配置）
批量操作	每次请求最多 100 个代码
缓存命中率	对频繁访问的代码为 70-90%
冷启动时间	<500ms
测试覆盖率	核心中间件达到 95%+

许可证

MIT

链接

• GitHub 仓库
• npm 包
• MCP 协议
• 报告问题