FinData MCP

FinData MCP

为 AI Agent 提供股票市场数据、公司基本面数据、FRED 宏观经济指标、SEC EDGAR 文件和加密货币价格——全部集成在一个 MCP 服务中。免费试用：每天 50 次调用。按次付费：通过 Base 上的 x402 微支付，每次调用 $0.01。无需注册，无需 API 密钥。

为 AI Agent 提供金融数据。五种工具涵盖实时股票价格（NYSE、NASDAQ，50,000 多种股票代码）、股票基本面数据（市盈率、收益、市值）、800,000 多个 FRED 经济序列（GDP、CPI、通胀、利率、美国国债收益率）、SEC EDGAR 文件（10-K 年报、10-Q、8-K）和加密货币价格（Bitcoin、Ethereum，8,000 多种币）。兼容 Claude Desktop、Cursor、Windsurf 和任何 MCP 客户端。

快速开始

安装：

pip install findata-mcp

设置钱包密钥（任意带有 Base 上 USDC 的 EVM 钱包）：

export EVM_PRIVATE_KEY=your_private_key_here

添加到 Claude Desktop——编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "findata-mcp": {
      "command": "findata-mcp",
      "env": {
        "EVM_PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

添加到 Cursor——编辑项目根目录中的 .cursor/mcp.json：

{
  "mcpServers": {
    "findata-mcp": {
      "command": "findata-mcp",
      "env": {
        "EVM_PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

重启客户端。现在即可使用五种金融数据工具。

---

工具

工具	返回内容	缓存
stock_quote(ticker)	价格、成交量、涨跌幅、市值	1 分钟
company_fundamentals(ticker)	营收、市盈率、行业、贝塔系数、股息率、描述	1 小时
economic_indicator(series_id)	800,000 多个 FRED 序列（GDP、CPI、利率、收益率曲线）	6 小时
sec_filing(ticker, form_type)	SEC EDGAR 中 10-K、10-Q、8-K 的全文	24 小时
crypto_price(coin_id)	价格、市值、24 小时成交量、7 天走势图	1 分钟

---

示例

获取股票报价

stock_quote(ticker="NVDA")

{
  "ticker": "NVDA",
  "price": 878.35,
  "change": 12.40,
  "change_pct": 1.43,
  "volume": 41200000,
  "market_cap": 2150000000000,
  "currency": "USD"
}

查询公司基本面数据

company_fundamentals(ticker="AAPL")

{
  "ticker": "AAPL",
  "name": "Apple Inc.",
  "sector": "Technology",
  "market_cap": 3280000000000,
  "pe_ratio": 33.2,
  "revenue": 383285000000,
  "beta": 1.24,
  "dividend_yield": 0.0044
}

查看经济指标

economic_indicator(series_id="FEDFUNDS")

{
  "series_id": "FEDFUNDS",
  "title": "Federal Funds Effective Rate",
  "units": "Percent",
  "frequency": "Monthly",
  "latest_value": 4.33,
  "latest_date": "2026-02-01"
}

常见的 FRED 序列：GDP、CPIAUCSL（通胀）、UNRATE（失业率）、DGS10（10 年期美国国债）、FEDFUNDS。

阅读 SEC 文件

sec_filing(ticker="AAPL", form_type="10-K")

{
  "ticker_or_cik": "AAPL",
  "form_type": "10-K",
  "filing_date": "2025-11-01",
  "document_url": "https://www.sec.gov/Archives/...",
  "content": "UNITED STATES SECURITIES AND EXCHANGE COMMISSION..."
}

也接受 ticker_or_cik（旧版参数）或 symbol 作为 ticker 的别名。

---

定价

每次调用 $0.01。 无需注册、无需 API 密钥、无月费。

付款通过 x402 自动完成，这是一种开放的微支付协议。每次调用时，MCP 客户端都会在 Base 主网上签署一笔 USDC 转账。你需要：

1. 一个 EVM 钱包私钥（设置为 EVM_PRIVATE_KEY）
2. Base 主网上少量 USDC 余额（约 $1 可支付 100 次调用）

仅此而已。无需账户，没有速率限制，也没有账单页面。

---

工作原理

pip install 安装包是一个轻量级 MCP stdio 服务。它会将工具调用代理到托管后端，并自动处理 x402 付款签名。数据来自 Yahoo Finance、FRED、SEC EDGAR 和 CoinGecko。

Your AI agent  →  findata-mcp (local stdio)  →  Backend (Railway)  →  Data providers
                  signs x402 payment              verifies payment

---

配置

变量	必需	默认值	描述
EVM_PRIVATE_KEY	是	—	带有 Base 上 USDC 的钱包私钥
FINDATA_BACKEND_URL	否	生产环境 URL	覆盖为可自托管后端

---

其他安装方式

uvx（无需安装）：

uvx findata-mcp

---

发布状态

• PyPI：findata-mcp
• Smithery：已上线
• Glama：已上线
• mcp.so：已上线

许可证

MIT