EDGAR Filings

EDGAR 文件 MCP

适用于 Cursor / Claude 的工具，返回的是SEC 文件编号，而不是网络搜索的猜测结果。

适用对象： 已在 IDE 聊天中，需要查询某个股票代码的 10-K/10-Q 标识、分部收入、BDC 非应计项目或 Form 4 条目，但不想编写 edgartools 胶水代码的人。

解决的问题： 模型会编造分部构成、内幕交易和 BDC 信用质量。这些工具会返回 accession、概念、期间、open_market、非应计方法和 EDGAR 索引 URL，方便你核对文件。

它不是什么： 不是研究产品、文档阅读器，也不能替代阅读 10-K。它仅将 edgartools 封装为四项工具。中国 PE、人形机器人和非上市信贷 CV 不在范围内——这些文件不在 EDGAR 上。

安装

如果 uv 已在 PATH 中，将以下内容粘贴到 ~/.cursor/mcp.json（Windows：%USERPROFILE%\.cursor\mcp.json）。请使用真实姓名和电子邮箱（SEC 常见问题）。相同片段也位于 examples/cursor.mcp.json 和 examples/claude.mcp.json 中。

{
  "mcpServers": {
    "edgar-filings": {
      "command": "uvx",
      "args": ["edgar-filings-mcp"],
      "env": {
        "EDGAR_IDENTITY": "Your Name [email protected]"
      }
    }
  }
}

PyPI 包 edgar-filings-mcp 已发布。注册表名称为 io.github.Dxfory/edgar-mcp。请勿使用 Smithery 托管服务。固定使用 mcp>=1.9,<2——MCP 2.x 重命名了 FastMCP；此包已固定在该版本范围内。

首次通过 uvx 启动时会下载 edgartools（pandas / pyarrow）。如果客户端似乎卡住，请在终端中运行一次 uvx edgar-filings-mcp，让 uv 缓存 wheel，然后重启 MCP 服务。之后，初始化只需几秒钟。

还没有 uv：

macOS / Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

irm https://astral.sh/uv/install.ps1 | iex

从 git 安装，而不是从 PyPI 安装：

uvx --from git+https://github.com/Dxfory/edgar-mcp.git edgar-filings-mcp

克隆（不使用 uv）

git clone https://github.com/Dxfory/edgar-mcp.git
cd edgar-mcp
python -m venv .venv

macOS / Linux：

.venv/bin/python -m pip install -e .

Windows：

.\.venv\Scripts\python -m pip install -e .

将客户端指向该解释器，并使用参数 ["-m", "edgar_mcp"]。

如果 PyPI SSL 失败（本地 HTTPS 代理环境中很常见），请使用镜像：

python -m pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

工具

工具	返回内容
get_trading_symbols	最新 10-K 或 10-Q 中的所有 dei:TradingSymbol，以及旧版 entity_info 标量
get_segment_revenue	按维度划分的 XBRL 收入（产品 / 业务 / 地理轴）
get_bdc_nonaccrual	BDC 非应计率、公允价值、具名投资及提取方法
get_form4	最新的 Form 4 摘要、交易条目、open_market 和 code_counts

get_trading_symbols、get_segment_revenue 和 get_bdc_nonaccrual 中的 form 可以是 10-K（默认值）或 10-Q。get_bdc_nonaccrual 仅接受 SEC BDC（814- 申报者），例如 ARCC。没有第五个工具。

本服务对热门主题会／不会回答的问题

主题	Agent 会编造的内容	工具	停止
AI 基础设施	NVIDIA / 超大规模云厂商的“AI 业务占比”	对 NVDA 使用 get_segment_revenue（Data Center 有标签）。AMZN/MSFT 的资本支出并非仅用于 AI	不要添加虚假的 AI 资本支出工具
私人信贷 / BDC	非应计项目、作为信用质量指标的 NAV、作为当前收入的 PIK	get_bdc_nonaccrual	非应计率 ≠ Fitch 违约率；PIK 仍可能计入应计
GP 主导的延续型基金	交易价格和“相对面值溢价”	无	私人二级市场不属于 EDGAR
中国 PE / 具身智能	融资规模和工厂工时	无	属于 SSE/HKEX，不属于 EDGAR

工具已提示的易踩坑点

• 如果重复出现 TradingSymbol 事实，entity_info.ticker 会采用最后一个。双重股权类别和优先股的代码可能会替换普通股代码。
• get_financials() 中不包含分部构成。一些报表的“DETAILED”视图会省略可报告分部的行；本服务会改为查询带维度的事实。
• Form 4 中的 A / M / F 分别表示授予、期权行权和税款预扣——open_market 为 false。
• BDC 的 extraction_method=none，或利率为零且提取器发出警告，都表示解析存在缺口，并不能证明账目没有问题。
• 最新的 10-K 可能是 10-K/A。工具优先选择原始表格，以免遗漏 Schedule-of-Investments 脚注。

不使用 Cursor 运行

python -m edgar_mcp

仅使用 stdio。请勿向 stdout 打印内容。

python tests/run_offline.py
python scripts/smoke_stdio.py
python scripts/pressure.py

smoke_stdio.py 仅检查初始化和四个工具名称（不访问 EDGAR）。将 uvx 加入 PATH 后：

python scripts/smoke_stdio.py -- uvx edgar-filings-mcp

pressure.py 会访问实时 EDGAR，需要设置 EDGAR_IDENTITY。

许可证

MIT。申报数据来自 SEC EDGAR 系统；本项目与 SEC 无关。