mcpField
S
Secfinapi

Secfinapi

本地服务
github.com/michalperni11-gif金融数据221 周前更新

关于 Secfinapi

Secfinapi 是本地 MCP 服务,通过 SECfinAPI 为 AI 助手提供实时、标准化的 SEC EDGAR 财务数据,可用于查询公司信息、财务报表和比率。

主要功能

  1. 01公司信息及 SEC 申报文件链接
  2. 02含申报日期的损益表
  3. 03资产负债表和现金流量表
  4. 0440 多项财务比率
  5. 05搜索美国上市公司

适用场景

  1. 01查看公司的收入趋势
  2. 02比较多家公司的营业利润率

MCP 相关

它向 MCP 客户端提供六种财务数据工具,数据来自 SECfinAPI REST API。服务在本地运行,需要 SECfinapi API 密钥。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"secfinapi": {
"command": "npx",
"args": [
"-y",
"secfinapi-mcp"
],
"env": {
"SECFINAPI_KEY": "<SECFINAPI_KEY>"
}
}
}
}
启动命令npx -y secfinapi-mcp
需要配置的环境变量
SECFINAPI_KEY密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmsecfinapi-mcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

secfinapi-mcp

适用于 SECfinAPI 的 MCP 服务——将标准化的 SEC EDGAR 财务数据(利润表、资产负债表、现金流量表、40 多项比率)作为工具提供给 Claude、Cursor 和其他 AI 助手。

向 AI 助手询问 “Apple 的收入趋势如何?” 或 “比较 MSFT 和 GOOGL 的营业利润率” 之类的问题——它会通过 SECfinAPI 实时获取数据。

它在你的本地计算机上运行,是 SECfinAPI REST API 的轻量封装。无需托管服务,也不会产生额外费用。

设置

  1. 在 https://www.secfinapi.com 免费获取 API 密钥。
  2. 将此服务添加到 AI 助手的 MCP 配置中。
Claude Desktop

打开 Settings → Developer → Edit Config 并添加:

发布到 npm 后:

{
  "mcpServers": {
    "secfinapi": {
      "command": "npx",
      "args": ["-y", "secfinapi-mcp"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

从源代码运行(发布前):

{
  "mcpServers": {
    "secfinapi": {
      "command": "node",
      "args": ["C:/path/to/sec-financial-mcp/dist/index.js"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

重启 Claude Desktop。下方的 6 个工具会显示在工具(🔌)菜单中。

Cursor / VS Code

在编辑器的 MCP 设置中使用相同的配置格式——command、args 和 SECFINAPI_KEY 环境变量。

工具

工具返回内容
get_company_info公司元数据 + SEC EDGAR 文件的链接
get_income_statement标准化利润表(含申报日期)
get_balance_sheet标准化资产负债表
get_cash_flow标准化现金流量表
get_metrics40 多项财务比率(ROE、ROIC、利润率、增长率……)
list_companies列出 / 搜索可用的美国上市公司

环境变量

变量必填默认值
SECFINAPI_KEY是—
SECFINAPI_BASE_URL否SECfinAPI 生产 API

从源代码运行

npm install
npm run build
SECFINAPI_KEY=your-key node dist/index.js

发布(维护者)

npm run build
npm publish

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。