/ 目录 / 演练场 / SEC EDGAR MCP
← 全部服务器 ↗ GitHub
● 社区 stefanoamorelli ⚡ 即开即用

SEC EDGAR MCP

作者 stefanoamorelli · stefanoamorelli/sec-edgar-mcp

在您的代理商的指尖接地美国文件— CIK查找， 10-K/10-Q/8-K ， XBRL财务，表格3/4/5内幕交易，每个答案都可以链接到SEC来源。

sec-edgar-mcp允许代理结构化地访问SEC的EDGAR系统。它通过股票代码或名称将公司解析为CIK ，提取特定文件（ 10-K ， 10-Q ， 8-K ） ，提取部分，将XBRL解析为资产负债表/利润表/现金流，并显示内幕交易（表格3/4/5 ）。每个回复都包含SEC URL ，因此您可以自行验证号码。仅限公共数据—除了合规的用户代理外，无需API密钥。

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

实时演示

实际使用效果

sec-edgar-mcp.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "sec-edgar-mcp",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "sec-edgar-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
          "stefanoamorelli/sec-edgar-mcp:latest"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add sec-edgar-mcp -- docker run -i --rm -e 'SEC_EDGAR_USER_AGENT=Your Name ([email protected])' stefanoamorelli/sec-edgar-mcp:latest

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： SEC EDGAR MCP

用确切的数字和引文快速阅读10-K

👤 覆盖上市公司的分析师、投资者、记者 ⏱ ~30 min intermediate

何时使用： 您今天下午需要阅读10-K ，而不是本周。

前置条件
  • SEC_EDGAR_USER_AGENT设置了您的姓名和电子邮箱 — SEC需要可联系的用户代理才能进行编程访问
步骤
  1. 解决公司问题
    查找Microsoft的CIK。✓ 已复制
    → CIK 0000789019已退回
  2. 拉出最新的10-K
    获取最新的10-K并提取风险因素部分。✓ 已复制
    → 风险因素部分返回了归档URL
  3. 拉数字
    摘录2025财年的资产负债表和利润表。✓ 已复制
    → 使用值+单位+归档URL清理行

结果： 一个易于消化的10-K阅读器，带有可验证的链接回到埃德加。

注意事项
  • 令人困惑的财政年度和日历年 — 始终在答案中打印会计期间，以便用户可以进行理智检查
搭配使用： yahoo-finance

跟踪观察名单的内幕交易

👤 追随内幕情绪的投资者 ⏱ ~20 min intermediate

何时使用： 您希望每日为您的观察列表提供有关表格4活动的简报。

步骤
  1. 列出每个股票代码的内部人员
    对于AAPL ， MSFT ， NVDA —在过去30天内提取表格4交易。✓ 已复制
    → 具有内部人员姓名、角色、买入/卖出、股票、价格、日期的行
  2. 聚合
    根据股票代码总结净内幕买入与卖出。✓ 已复制
    → 每股股票代码一行，净方向

结果： 一款清脆的内幕短裤，无需手工刮擦EDGAR。

注意事项
  • 将期权相关交易计为“购买” — 筛选交易代码； P/S与A/M/D事项
搭配使用： alpaca

在观察列表中总结今天的8-K申请

👤 新闻编辑室、企业开发团队、投资者关系 ⏱ ~10 min beginner

何时使用： 发生了一些重要的事情；您希望快速完成简单的英文摘要。

步骤
  1. 提取最近的8-K
    将今天的8-K文件提取到我的观察名单中。✓ 已复制
    → 每次归档：项目代码+链接
  2. 總結
    对于每个，一句普通的英语摘要，并带有项目代码。✓ 已复制
    → 使用SEC URL清除摘要

结果： 您可以信任并链接的观察列表摘要。

搭配使用： fetch

并排比较两家公司的财务状况

👤 股票分析师、学生建立模型 ⏱ ~20 min intermediate

何时使用： 你需要一个快速的苹果对苹果比较。

步骤
  1. 拉取两家公司的XBRL
    获取AAPL和MSFT在2024财年的收入、毛利润、营业收入、净收入。✓ 已复制
    → 与单位和归档URL对齐的表
  2. 不同的边距
    计算和比较毛利率和营业利润率。✓ 已复制
    → 并排边距；链接到每个归档

结果： 与确切的源URL进行可防御的比较。

搭配使用： antv-chart

组合

与其他 MCP 搭配，撬动十倍杠杆

sec-edgar-mcp + yahoo-finance

将SEC基本面与当前市场报价配对

拉动MSFT最新的10-K净收入和今天的市值；计算隐含倍数。✓ 已复制
sec-edgar-mcp + alpaca

使用内幕信号作为屏幕

对于过去30天内有内幕买家的股票，请列出羊驼的当前价格。✓ 已复制
sec-edgar-mcp + antv-chart

绘制提取的XBRL数字图表

提取5年的收入，并用蚂蚁电视图表绘制。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
lookup_cik ticker_or_name: str 任何公司查询的第一步 1 SEC request
get_company_facts cik: str 了解报告了哪些行项目 1 SEC request
get_filings cik: str, form_type: str, limit?: int 拉取10-K/10-Q/8-K文件 1 SEC request
extract_section accession_number: str, section: str 阅读特定章节（例如，风险因素、MD&A ） 1 SEC request
get_financials cik: str, period: str 结构化财务报表（含单位） 1 SEC request
get_insider_transactions cik: str, days?: int 表格3/4/5活动 1 SEC request

成本与限制

运行它的成本

API 配额
SEC速率限制：每个IP约10个请求/秒—请遵守
每次调用 Token 数
对于元数据而言，归档可能非常大（数万个令牌）
费用
免费—埃德加是公开的
提示
使用extract_section而不是转储整个文件；仅MD&A或Risk Factors部分通常就足够了。

安全

权限、密钥、影响范围

凭据存储： SEC_EDGAR_USER_AGENT将您识别为SEC ；使用真实姓名和可联系的电子邮件。请勿将您的个人电子邮件提交到共享配置。
数据出站： 所有调用都转到sec.gov。默认配置中没有第三方服务。

故障排查

常见错误与修复

403 from sec.gov

您的User-Agent缺失或格式不正确。SEC需要'Name ([email protected])'格式。

验证： echo $SEC_EDGAR_USER_AGENT
限价(429)

退回到10个请求/秒以下。按CIK批处理，而不是发出许多并行调用。

验证： Inspect headers on the failing response
未找到XBRL概念

公司不得报告该概念。使用get_company_facts查看存在哪些概念。

验证： get_company_facts(cik) and grep for the concept

替代方案

SEC EDGAR MCP 对比其他方案

替代方案何时用它替代权衡
yahoo-finance您想要没有SEC级别精度的报价+基本基本原理权威性较低；无直接备案
alpaca您需要经纪市场数据和交易无归档；不同的数据形状

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills