← 返回目录

SEC EDGAR MCP Server

社区

通过 MCP 查询 SEC EDGAR 申报文件、XBRL 财务数据和公司信息，支持 STDIO 和流式 HTTP。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 10 / 58
Stars: ★ 10 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Bun 1.3.0+ · Node.js · Docker · 远程托管（无需本地环境）
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 5 天前
工具数: 17

68FMRS · C

该服务器提供了一个全面的工具，用于通过 MCP 访问 SEC EDGAR 数据，涵盖了广泛的金融数据集，并提供了强大的 SQL 分析能力。它由社区维护，并非官方 SEC 工具，但遵循 SEC 的 API 条款。

最强项 · 文档质量 17/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

15/20

维护活跃度

11/20

文档质量

17/20

安装易用性

14/20

查看各项评分依据

可靠性 11/20: README 对每个工具的行为边界（分页、caveats、截断、archive 路由）描述极为详尽，并声称有测试套件（tests/ 目录、bun run test），但静态审查无实际执行或 CI 证据，无法验证 17 个工具与文档一致；版本 0.15.2 仍在 0.x 阶段。扣分：无可验证的执行证据。
安全与权限 15/20: 无 API 密钥要求，唯一凭据类输入是合规 User-Agent；SQL 工具默认只读，写入/DDL/DROP 被拒绝，系统目录被屏蔽，唯一破坏性工具 dataframe_drop 需显式环境变量开启；公开托管实例默认无认证（MCP_AUTH_MODE=none）且使用方需信任第三方主机读取其查询流量，未提供部署端默认认证保障，扣分。无红线问题。
维护活跃度 11/20: 版本化发布至 npm（0.15.2）、Apache-2.0 许可证、Docker/ghcr 发布、更新日志式 README 均可见；但 7 星、0 open issues 无法证明 issue 响应能力，未见 SECURITY.md 或安全响应渠道证据，单人维护（cyanheads）风险未披露。
文档质量 17/20: 文档质量突出：工具参数、限制（EFTS 2001 索引下限、13D/13G 覆盖起点、NPORT 延迟）、成本（SEC 速率、50 文档扫描约 5 秒）、配置表、故障排查路径均有披露，并诚实说明 caveats 与不可覆盖的场景；扣分在于部分声明（如三态 search 路由）难以静态复核，troubleshooting 仍偏薄。
安装易用性 14/20: 提供 Claude Desktop (MCPB)、Cursor、VS Code 一键安装链接及 stdio/npx/bunx/HTTP/Docker 配置示例，必需变量仅 EDGAR_USER_AGENT，DuckDB 在 Workers 上不可用已说明；扣分：依赖 Bun（推荐）或 npx 拉取、可选 mirror 初始化增加复杂度，且无 CI/执行证据证明示例可直接运行，静态校准上限内给分。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要快速、结构化地访问 SEC 申报数据的金融分析师和研究人员。
希望在 MCP 客户端中直接进行 SEC 数据 SQL 查询的开发者。
对 XBRL 数据感兴趣的监管科技和数据科学家。

不适合谁

需要在无网络环境下访问历史申报数据（但是可使用本地镜像功能）。
需要金融数据实时流式传输或极低延迟的场景（SEC 有速率限制和发布延迟）。
希望避免自行设置 `EDGAR_USER_AGENT` 的用户（但可使用托管实例）。

所需权限

访问 SEC EDGAR 公共 API（无 API 密钥，但需要有效的 User-Agent 头）。
仅在本地配置时，可在本地运行二进制文件以启动服务器进程。
可选：使用本地 SQLite 镜像功能时，可在磁盘上存储数据和缓存。

风险与副作用

SEC 要求必须设置有效的 User-Agent，格式如“应用名邮箱”；否则可能被 SEC 屏蔽 IP。
该工具访问的是公共 API，在请求频率过高时可能受到限制。
生产环境使用此非官方服务器时需评估可靠性和维护状态。

安装接入

准备工作

运行环境：Bun 1.3.0+ · Node.js · Docker · 远程托管（无需本地环境）

EDGAR_USER_AGENT 必填 SEC要求的User-Agent标识，格式为“应用名称联系邮箱”，需自行填写你的应用名和邮箱，必填。

其他可选配置项（17 个）

EDGAR_RATE_LIMIT_RPS 可选对SEC API的最大请求速率，默认10，不应超过10。

EDGAR_TICKER_CACHE_TTL 可选公司股票代码查找文件的缓存时长（秒），默认3600。

EDGAR_DATASET_TTL_SECONDS 可选 canvas数据表的TTL（秒），默认86400。

EDGAR_DATAFRAME_DROP_ENABLED 可选设为true以启用secedgar_dataframe_drop工具，默认关闭。

EDGAR_MIRROR_ENABLED 可选启用本地SQLite镜像以读取本地数据，默认false。

EDGAR_MIRROR_PATH 可选存放镜像SQLite数据库的目录，默认./data/edgar-mirror。

EDGAR_MIRROR_REFRESH_CRON 可选进程内夜间刷新的cron表达式（仅HTTP传输），如0 9 * * *。

EDGAR_MIRROR_FALLBACK_LIVE 可选镜像未命中时是否回退到线上SEC API，默认true。

CANVAS_PROVIDER_TYPE 可选 Canvas引擎类型，默认duckdb，设为none可禁用。

MCP_TRANSPORT_TYPE 可选传输方式：stdio或http，默认stdio。

MCP_HTTP_PORT 可选 HTTP服务器端口，默认3010。

MCP_AUTH_MODE 可选认证模式：none、jwt或oauth，默认none。

MCP_LOG_LEVEL 可选日志级别，默认info。

LOGS_DIR 可选日志文件目录（仅Node.js），默认为项目根目录下的logs。

MCP_HTTP_HOST 可选 HTTP服务器主机名，默认127.0.0.1。

MCP_HTTP_ENDPOINT_PATH 可选 MCP服务器的端点路径，默认/mcp。

MCP_PUBLIC_URL 可选 TLS代理后面的公网地址覆盖，直接部署时留空。

直接使用公共托管实例：在 MCP 客户端中配置 URL https://secedgar.caseyjhand.com/mcp（Streamable HTTP）。
或者本地运行：创建包含命令和参数的 stdio 配置（如 npx -y @cyanheads/secedgar-mcp-server@latest），并设置环境变量 EDGAR_USER_AGENT（格式为“应用名邮箱”）。
自托管 HTTP 传输：设置 MCP_TRANSPORT_TYPE=http，使用 Bun 运行 bun run start:http，默认监听 http://localhost:3010/mcp。

claude_desktop_config.json

{
  "mcpServers": {
    "secedgar-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/secedgar-mcp-server@latest"
      ],
      "env": {
        "EDGAR_USER_AGENT": "YourAppName [email protected]"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "secedgar-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/secedgar-mcp-server@latest"
      ],
      "env": {
        "EDGAR_USER_AGENT": "YourAppName [email protected]"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add secedgar-mcp-server -e 'EDGAR_USER_AGENT=YourAppName [email protected]' -- npx -y @cyanheads/secedgar-mcp-server@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在MCP客户端配置连接后，检查工具列表中是否出现secedgar_company_search等工具；然后输入“搜索苹果公司的基本信息”，如果返回苹果的CIK等实体信息，则说明安装成功。

常见排障

确保环境变量 `EDGAR_USER_AGENT` 已设置且格式正确。
检查网络连接和是否被 SEC 限流。
验证 MCP 客户端配置中的命令参数和环境变量是否正确。
如果使用公共实例，确保其在线（可能需要查看项目主页）。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用ticker搜索苹果公司并返回它最近提交的10-K文件
查询微软最近三年的年度营收数据
列出沃伦·巴菲特旗下伯克希尔13F报告中的最新持仓
对比苹果和谷歌最近四个季度的净利润和稀释每股收益

工具能力 17

secedgar_company_search 只读

按代码、名称或 CIK 搜索公司并获取实体信息，可选择包含近期申报文件。

secedgar_search_filings 只读

自 1993 年以来的 EDGAR 申报搜索，支持全文搜索（2001 年后）和档案浏览（2001 年前）。

secedgar_get_filing 只读

通过登录号获取特定申报文件的元数据和文档内容。

secedgar_get_financials 只读

获取公司的历史 XBRL 财务数据，支持友好概念名称解析。

secedgar_get_snapshot 只读

只需一次调用即可获取公司财务摘要，包括所有支持的概念的最新值。

secedgar_get_material_events 只读

获取 8-K 申报文件，并将项目代码解码为可读的事件类型，可进行过滤。

secedgar_get_insider_transactions 只读

解析 Form 4/4-A 所有权 XML，获取内幕交易（买入、卖出、赠与、行使）。

secedgar_get_institutional_holdings 只读

解析 13F-HR 信息表，获取季度机构持仓。

展开其余 9 个工具

secedgar_find_holders 只读

反向查找：哪些机构报告持有了某个发行人的证券。

secedgar_get_beneficial_owners 只读

解析结构化 13D/13G 申报文件，获取发行人的 5% 以上受益所有人信息。

secedgar_get_fund_holdings 只读

从季度 NPORT-P 报告中获取 ETF 和共同基金的持仓。

secedgar_fetch_frames 只读

获取一个概念在一个期间内所有申报公司的 SEC XBRL 框架数据。

secedgar_compare_companies 只读

按日历期间对齐比较 2-10 家公司的财务数据。

secedgar_search_concepts 只读

发现受支持的 XBRL 概念名称，或反向查找原始标签。

secedgar_dataframe_describe 只读

列出画布数据帧，包括来源、TTL 和模式。

secedgar_dataframe_query 只读

对多个数据帧执行单语句的 SQL SELECT 查询。

secedgar_dataframe_drop 破坏性

按名称删除画布数据帧。可选工具，默认关闭（需环境变量 EDGAR_DATAFRAME_DROP_ENABLED=true）。

使用场景

分析上市公司的财务健康状况和申报历史。

监控内幕交易和机构持仓变动。

获取特定基金或 ETF 的最新投资组合持仓。

在全市场范围内比较不同公司的财务指标。

筛选和过滤重要事件（如 8-K 申报）

支持客户端

Claude Desktop

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

SEC EDGAR MCP 服务器是一个基于 TypeScript 构建的 MCP 服务器，提供 17 个工具（其中 1 个可选）用于访问 SEC EDGAR 数据库。它支持公司搜索、申报文件检索、XBRL 财务数据查询、内幕交易、机构持股、受益所有人、基金持仓等，并提供基于 DuckDB 的数据帧 SQL 分析功能。它通过 stdio 或 Streamable HTTP 运行，无需 API 密钥。