EDGAR MCP — SEC companyfacts、frames、Form 4、13F

通过 User-Agent 连接 SEC EDGAR 的 MCP 服务器。无需 API key。财务数据不通过 FMP，而是通过 companyfacts / frames 读取；XBRL tag 映射位于 xbrl_map.py 中。

工具

Related MCP server: edgarmcp

安装

cd edgar-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env

.env 中的 EDGAR_USER_AGENT 必须是真实姓名 + 电子邮件。SEC 会以 403 拒绝通用的 python-requests 代理。

EDGAR_USER_AGENT=Your Name your.email@example.com
MCP_TRANSPORT=stdio

Cursor（stdio）

%USERPROFILE%\.cursor\mcp.json：

{
  "mcpServers": {
    "edgar": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "C:\\Users\\yunus\\Documents\\dev\\edgar-mcp",
      "env": {
        "MCP_TRANSPORT": "stdio",
        "EDGAR_USER_AGENT": "Your Name your.email@example.com"
      }
    }
  }
}

Railway → Claude（Streamable HTTP）

如果存在 PORT，默认 transport 为 http，endpoint 为 https://<railway-host>/mcp。不要设置 MCP_TRANSPORT=stdio — 进程不会监听，Railway 显示 "online"，但 Claude 无法连接。

变量

检查： https://<host>/health → {"ok": true, ...}

Claude（claude.ai / Desktop Connectors）

1. Customize → Connectors → Add custom connector

2. URL：https://<host>/mcp（末尾不是 /sse）

3. OAuth 字段留空，关闭 Individual sign-in

4. 点击 Add，在聊天中用 + → Connectors 打开

如果 Claude Code 能发送 header，则设置 MCP_AUTH_REQUIRED=true 和 Authorization: Bearer <token>。

旧版 /sse 使用 MCP_TRANSPORT=sse（Claude connector 不推荐）。

测试

python -m unittest tests.test_xbrl_map tests.test_form_parsers tests.test_http_auth tests.test_client_utils

资源

• companyfacts / concept / frames：https://data.sec.gov

• submissions：https://data.sec.gov/submissions

• archives：https://www.sec.gov/Archives/edgar

• full-text：https://efts.sec.gov/LATEST/search-index

• Fair Access：https://www.sec.gov/os/webmaster-faq#code-support（最多 10 req/s，必须提供 User-Agent）

13F 数值按 SEC 惯例以 千美元 为单位。13F 由机构填写，而非个股。