内容
# FinData MCP
[](https://mcp.directory/servers?q=findata-mcp)
> 为 AI 代理提供实时的金融数据。股票报价、公司基本面、800,000+ 个 FRED 经济指标、SEC 文件和加密货币价格。按调用支付（$0.01），通过 Base 上的 x402 微支付——无需注册或 API 密钥。
<!-- mcp-name: io.github.sapph1re/findata-mcp -->
金融数据适用于 AI 代理。五种工具——股票、基本面、经济、SEC 文件、加密货币——可从任何 MCP 客户端访问。按调用支付 $0.01，无需注册。
## 快速开始
**安装：**
```bash
pip install findata-mcp
```
**设置您的钱包密钥**（任何带有 Base 上 USDC 的 EVM 钱包）：
```bash
export EVM_PRIVATE_KEY=您的私钥
```
**添加到 Claude Desktop** — 编辑 `~/Library/Application Support/Claude/claude_desktop_config.json：
```json
{
"mcpServers": {
"findata-mcp": {
"command": "findata-mcp",
"env": {
"EVM_PRIVATE_KEY": "您的私钥"
}
}
}
}
```
**添加到 Cursor** — 编辑项目根目录下的 `.cursor/mcp.json：
```json
{
"mcpServers": {
"findata-mcp": {
"command": "findata-mcp",
"env": {
"EVM_PRIVATE_KEY": "您的私钥"
}
}
}
}
```
重启您的客户端。现在您有五种金融数据工具可用。
---
## 工具列表
| 工具 | 返回内容 | 缓存 |
|------|----------------|-------|
| `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")
```
```json
{
"ticker": "NVDA",
"price": 878.35,
"change": 12.40,
"change_pct": 1.43,
"volume": 41200000,
"market_cap": 2150000000000,
"currency": "USD"
}
```
### 查询公司基本面
```
company_fundamentals(ticker="AAPL")
```
```json
{
"ticker": "AAPL",
"name": "苹果公司",
"sector": "技术",
"market_cap": 3280000000000,
"pe_ratio": 33.2,
"revenue": 383285000000,
"beta": 1.24,
"dividend_yield": 0.0044
}
```
### 查询经济指标
```
economic_indicator(series_id="FEDFUNDS")
```
```json
{
"series_id": "FEDFUNDS",
"title": "联邦基金有效利率",
"units": "百分比",
"frequency": "每月",
"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")
```
```json
{
"ticker_or_cik": "AAPL",
"form_type": "10-K",
"filing_date": "2025-11-01",
"document_url": "https://www.sec.gov/Archives/...",
"content": "美国证券交易委员会..."
}
```
也接受 `ticker_or_cik`（旧版）或 `symbol` 作为 `ticker` 的别名。
---
## 定价
**每调用 $0.01**。无需注册、无需 API 密钥、无月费。
支付通过 [x402](https://www.x402.org/)——一个开放的微支付协议自动进行。您的 MCP 客户端在 Base 主网上为每个调用签署 USDC 转账。您需要：
1. EVM 钱包私钥（设置为 `EVM_PRIVATE_KEY`）
2. Base 主网上的一小笔 USDC 余额（~$1 涵盖 100 次调用）
就这样。无需账户，无速率限制，无计费页面。
---
## 工作原理
`pip install` 包是一个薄的 MCP stdio 服务器。它将您的工具调用代理到托管后端，自动处理 x402 支付签名。数据来自雅虎财经、FRED、SEC EDGAR 和 CoinGecko。
```
您的 AI 代理 → findata-mcp（本地 stdio）→ 后端（Railway）→ 数据提供商
签署 x402 支付 验证支付
```
---
## 配置
| 变量 | 必需 | 默认值 | 描述 |
|----------|----------|---------|-------------|
| `EVM_PRIVATE_KEY` | 是 | — | 带有 Base 上 USDC 的钱包私钥 |
| `FINDATA_BACKEND_URL` | 否 | 生产 URL | 自托管后端的覆盖 |
---
## 替代安装方法
**uvx**（无需安装）：
```bash
uvx findata-mcp
```
---
## 分发状态
- PyPI：[findata-mcp](https://pypi.org/project/findata-mcp/)
- Glama：[在线](https://glama.ai/mcp/servers/sapph1re/findata-mcp)
- mcp.so：[在线](https://mcp.so/server/findata-mcp/sapph1re)
- 官方 MCP 注册表：待审核
- PyPI：在线
## 许可证
MIT
