us-gov-data-mcp

一个用于美国政府数据的 MCP 服务器。向你的 AI 助手询问哪些联邦合同即将到期，或哪些上市公司去年收入最高——并得到你可以对照政府官方记录核实的答案。

基于美国财政部的 USAspending API 和 SEC 的 EDGAR XBRL 数据构建。无需爬取、无需 API 密钥、无需账户、不涉及个人数据。

为什么存在

这两个数据源发布所有内容，但几乎不允许你查询其中任何内容。

usaspending.gov 无法按合同结束日期搜索。 但当联邦合同的履约期结束时，工作通常必须重新竞标——而这些重新竞标是政府合同中概率最高的机会，在招标公告出现前几个月就能在公开数据中看到。

sec.gov 一次只能查看一家公司的申报文件。 该网站上无法查询哪些上市公司收入超过 1000 亿美元，或哪些公司持有最多现金。SEC 的 frames API 可以在一次调用中回答覆盖约 5,800 家申报公司的问题——前提是你已经知道 XBRL 标签和期间格式。

这个服务器回答了那些网站无法回答的问题。

Related MCP server: sec-edgar-mcp

四个工具

find_expiring_contracts — 重新竞标

即将重新招标的联邦合同，包含现任承包商和剩余天数。expiring_after_days 设置你的投标提前期，因为下周就结束的合同没有准备的价值。

{
  "days_until_expiry": 120,
  "recipient": "PERATON ENTERPRISE SOLUTIONS LLC",
  "amount_usd": 682369225.00,
  "awarding_agency": "General Services Administration",
  "verify_url": "https://www.usaspending.gov/award/..."
}

search_federal_contracts

按机构、关键词、日期或金额查询已授予的合同。谁在赢得联邦项目、某个机构的支出、竞争对手的历史。

screen_public_companies

按任何已报告的财务指标对所有美国上市公司进行排名。

"哪些公司在 2023 年收入超过 2000 亿美元？"

{ "company": "Walmart Inc.", "value": 648125000000, "unit": "USD",
  "period_end": "2023-12-31", "period_type": "annual",
  "verify_url": "https://www.sec.gov/Archives/edgar/data/104169/..." }

company_financial_history

一家公司某个指标的报告历史——收入、净利润、资产、现金流——去重后，每条记录包含表格类型和申报日期。

一切皆可验证

每条记录都带有指向其来源政府申报文件的 verify_url。打开并对比。

当 AI 参与其中时这一点最为重要：当助手报告一个美元数字时，你应该能够对照来源进行核实，而不是信任整个链条。如果某个数值与官方记录不一致，那就是一个 bug——请提交 issue。

它为你处理的三个陷阱

原始 SEC 数据在三个方面具有误导性，每一种都是静默的——你得到的是一个看似合理的错误数字，而不是报错。

1. 10-Q 报告了季度和截至同一天的年累计数据。 跨申报文件比较净利润会静默地混淆三个月的数据和九个月的数据。每条记录都带有 period_type，你可以据此过滤。

2. 同一事实在不同申报文件中以不同数值重复出现。 今年的 10-K 会重述去年的数据。去重为每个期间一条记录，以最近的申报文件为准——这正是 SEC 自己对重述的处理方式。

3. 公司会随时间更换 XBRL 标签。 Microsoft 在 2010 年之前申报的是 Revenues，之后换成了不同的标签。只取第一个返回数据的标签会得到过时且不完整的历史；本工具会合并所有标签的数据。

安装

uvx --from git+https://github.com/groundtruthtools/us-gov-data-mcp us-gov-data-mcp

Claude Desktop —— 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "us-gov-data": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/groundtruthtools/us-gov-data-mcp",
        "us-gov-data-mcp"
      ],
      "env": { "SEC_USER_AGENT": "Your Name your@email.com" }
    }
  }
}

适用于任何 MCP 客户端：Claude Desktop、Claude Code、Cursor、VS Code。

SEC_USER_AGENT 值得设置。 SEC 的公平访问政策要求 User-Agent 包含联系地址，没有该信息的请求会收到 403。已包含默认值，因此工具开箱即用，但表明你的身份是礼貌之举，也能避免使用共享身份。

一个用惨痛教训学到的怪癖：不要在该字符串中放入 URL。 SEC 对任何包含 URL 的 User-Agent 都会返回 403。Your Name your@email.com 可以；加上 github.com/... 就不行。

尚未发布到 PyPI，因此请从仓库安装。当它发布到 PyPI 后，这将变成简单的 uvx us-gov-data-mcp。

诚实的局限

• 合同：已授予的，而非公开招标。 如需已发布的招标公告，请使用 SAM.gov。

• 合同：仅限联邦，2008 财年之前没有数据。

• 重新竞标搜索覆盖过去一年内有活动的合同，因为 USAspending 限制了结果可以翻页的深度。长期处于休眠状态的合同可能不会出现，而过宽的搜索会明确说明这一点，而不是返回一个看似确定但实际为空的列表。

• SEC：XBRL 覆盖范围从 2009 年左右开始，且仅涵盖公司实际标记的概念。较小的申报公司标记的内容更少。

• 它报告数据；不进行计算。 没有比率、增长率或衍生指标——那些将是我们的计算而非申报文件内容，你也无法对照来源进行核实。

• 非投资建议。 它是一个数据格式化工具。

也可在 Apify 上使用

相同的逻辑以托管工具形式运行，无需安装：

• US Federal Contract Awards & Recompete Finder

• SEC EDGAR Financial Data & Company Screener

数据来源与许可

合同：USAspending.gov，美国财政部，根据 DATA Act 发布。 财务数据：SEC EDGAR，美国证券交易委员会。 两者均为公有领域。代码：MIT。