内容
# secfinapi-mcp
SECfinAPI 的 MCP 服务器 — 提供标准化的美国证券交易委员会 EDGAR 财务数据（损益表、资产负债表、现金流、40 多项比率）作为 Claude、Cursor 等 AI 助手的工具。
向 AI 助手提问，例如 *"苹果公司的收入趋势如何？"* 或 *"比较微软和谷歌的营业利润率"* — 它通过 SECfinAPI 实时获取数据。
它在您的本地机器上运行，是 SECfinAPI REST API 的一个薄封装。无需托管服务器，无需额外成本。
## 设置
1. 在 <https://www.secfinapi.com> 获取一个免费的 API 密钥。
2. 将服务器添加到 AI 助手的 MCP 配置中。
### Claude 桌面版
打开 **设置 → 开发者 → 编辑配置** 并添加：
**发布到 npm 后：**
```json
{
"mcpServers": {
"secfinapi": {
"command": "npx",
"args": ["-y", "secfinapi-mcp"],
"env": { "SECFINAPI_KEY": "在此处输入您的 API 密钥" }
}
}
}
```
**从源代码运行（发布前）：**
```json
{
"mcpServers": {
"secfinapi": {
"command": "node",
"args": ["C:/path/to/sec-financial-mcp/dist/index.js"],
"env": { "SECFINAPI_KEY": "在此处输入您的 API 密钥" }
}
}
}
```
重启 Claude 桌面版。以下 6 种工具将出现在工具（🔌）菜单下。
### Cursor / VS Code
在编辑器的 MCP 设置中使用相同的配置格式 — `command`、`args` 和 `SECFINAPI_KEY` 环境变量。
## 工具
| 工具 | 返回值 |
|------|---------|
| `get_company_info` | 公司元数据 + 指向 SEC EDGAR 文件的链接 |
| `get_income_statement` | 标准化的损益表（包含申报日期） |
| `get_balance_sheet` | 标准化的资产负债表 |
| `get_cash_flow` | 标准化的现金流表 |
| `get_metrics` | 40 多项财务比率（ROE、ROIC、利润率、增长率……） |
| `list_companies` | 美国上市公司的列表 / 搜索 |
## 环境变量
| 变量 | 是否必需 | 默认值 |
|----------|----------|---------|
| `SECFINAPI_KEY` | 是 | — |
| `SECFINAPI_BASE_URL` | 否 | SECfinAPI 生产环境 API |
## 从源代码运行
```bash
npm install
npm run build
SECFINAPI_KEY=您的密钥 node dist/index.js
```
## 发布（维护者）
```bash
npm run build
npm publish
```
## 许可证
MIT
