适合谁
- 需要快速、结构化地访问 SEC 申报数据的金融分析师和研究人员。
- 希望在 MCP 客户端中直接进行 SEC 数据 SQL 查询的开发者。
- 对 XBRL 数据感兴趣的监管科技和数据科学家。
S
68FMRS · C
该服务器提供了一个全面的工具，用于通过 MCP 访问 SEC EDGAR 数据，涵盖了广泛的金融数据集，并提供了强大的 SQL 分析能力。它由社区维护，并非官方 SEC 工具，但遵循 SEC 的 API 条款。
SEC EDGAR MCP 服务器是一个基于 TypeScript 构建的 MCP 服务器，提供 17 个工具（其中 1 个可选）用于访问 SEC EDGAR 数据库。它支持公司搜索、申报文件检索、XBRL 财务数据查询、内幕交易、机构持股、受益所有人、基金持仓等，并提供基于 DuckDB 的数据帧 SQL 分析功能。它通过 stdio 或 Streamable HTTP 运行，无需 API 密钥。
工具能力
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 信息表，获取季度机构持仓。
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）。
安装接入
- 直接使用公共托管实例：在 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]"
}
}
}
}
选型与风险
不适合谁
- 需要在无网络环境下访问历史申报数据（但是可使用本地镜像功能）。
- 需要金融数据实时流式传输或极低延迟的场景（SEC 有速率限制和发布延迟）。
- 希望避免自行设置 `EDGAR_USER_AGENT` 的用户（但可使用托管实例）。
所需权限
- 访问 SEC EDGAR 公共 API（无 API 密钥，但需要有效的 User-Agent 头）。
- 仅在本地配置时，可在本地运行二进制文件以启动服务器进程。
- 可选：使用本地 SQLite 镜像功能时，可在磁盘上存储数据和缓存。
风险与副作用
- SEC 要求必须设置有效的 User-Agent，格式如“应用名 邮箱”；否则可能被 SEC 屏蔽 IP。
- 该工具访问的是公共 API，在请求频率过高时可能受到限制。
- 生产环境使用此非官方服务器时需评估可靠性和维护状态。
常见排障
- 确保环境变量 `EDGAR_USER_AGENT` 已设置且格式正确。
- 检查网络连接和是否被 SEC 限流。
- 验证 MCP 客户端配置中的命令参数和环境变量是否正确。
- 如果使用公共实例，确保其在线（可能需要查看项目主页）。
使用场景
分析上市公司的财务健康状况和申报历史。
监控内幕交易和机构持仓变动。
获取特定基金或 ETF 的最新投资组合持仓。
在全市场范围内比较不同公司的财务指标。
筛选和过滤重要事件（如 8-K 申报）
支持客户端
Claude Desktop完整支持
Cursor完整支持
VS Code完整支持