us-govdata-mcp

用于美国政府数据的 MCP 服务器 — 从 Claude、Cursor 或任何 Model Context Protocol 客户端搜索建筑许可证、联邦合同机会（SAM.gov）和国家医疗保健提供者注册中心（NPI/NPPES）。

所有三个数据源均来自官方政府出版物（城市开放数据门户、SAM.gov 的公共数据提取、CMS NPPES API）——无需 HTML 抓取、无需登录、无需脆弱的 CSS 选择器。繁重的工作由三个生产级 Apify Actor 完成，这些 Actor 在您自己的 Apify 账户上运行。

30 秒内试用 — 无需账户，无需付费

在您决定是否值得使用 API 令牌之前，无需任何配置即可运行：

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_DRY_RUN": "1" }
    }
  }
}

这就是完整的设置。在干运行模式下，每个工具都会返回逼真的示例记录以及它本应发送的精确 Apify API 请求——这样您就可以看到数据的真实结构，确认您的代理正确调用了工具，并阅读每个工具描述中的定价说明，而无需创建账户、粘贴令牌或花费任何费用。

向您的代理询问类似 "查找本月在奥斯汀签发的价值超过 50 万美元的建筑许可证" 这样的问题，并观察工具调用的完整过程。当您需要实时数据时，删除 APIFY_DRY_RUN 行并添加 APIFY_TOKEN（如下所示）。

Related MCP server: DOL WHD MCP

工具

* 诚实的定价说明： 这些工具运行由 CBLU 发布的付费、按结果计费的 Apify Actor。您的 Apify 账户仅按实际返回的记录收费——没有订阅费或启动费。每个工具默认每次调用返回 25 条结果，因此一次典型调用的成本不到一分钱（25 条许可证 ≈ $0.13；25 条合同通知 ≈ $0.10；25 条提供者信息 ≈ $0.05）。Apify 的免费计划包含每月平台积分，足以让您免费随意使用这些工具。包含完整定价详情的 Actor 页面：

• 美国建筑许可证抓取器

• SAM.gov 合同机会抓取器

• NPI 注册中心抓取器

快速开始

1. 获取 Apify 令牌（免费，约 2 分钟）

1. 在 https://console.apify.com/sign-up 注册（免费计划即可）。

2. 从 https://console.apify.com/settings/integrations 复制您的 API 令牌。

服务器无需令牌即可启动并列出其工具——令牌仅在实际调用工具时才需要。

2. 将服务器添加到您的 MCP 客户端

Claude Desktop（claude_desktop_config.json → 设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": {
        "APIFY_TOKEN": "your_apify_token_here"
      }
    }
  }
}

Claude Code：

claude mcp add us-govdata -e APIFY_TOKEN=your_apify_token_here -- npx -y github:CBLU2005/us-govdata-mcp

Cursor / Windsurf / 其他 MCP 客户端（与 Claude Desktop 格式相同）：

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_TOKEN": "your_apify_token_here" }
    }
  }
}

从本地克隆启动：

git clone https://github.com/CBLU2005/us-govdata-mcp.git
cd us-govdata-mcp
npm install && npm run build
# then point your client at: node /path/to/us-govdata-mcp/dist/index.js

Docker：

docker build -t us-govdata-mcp .
docker run -i --rm -e APIFY_TOKEN=your_apify_token_here us-govdata-mcp        # stdio
docker run --rm -p 3000:3000 -e APIFY_TOKEN=... us-govdata-mcp --http 3000    # Streamable HTTP

3. 向您的 AI 代理询问类似问题

• "查找本月在奥斯汀签发的价值超过 50 万美元的新建建筑许可证，并包含承包商名称。"

• "是否有任何活跃的小型企业预留网络安全招标，且响应截止日期在今天之后？请包含合同官员的电子邮件。"

• "列出大迈阿密地区（邮政编码 331）的牙医及其执业电话号码。"*

传输方式

• stdio（默认）——桌面 MCP 客户端使用的传输方式：us-govdata-mcp

• Streamable HTTP——无状态端点，位于 POST /mcp，健康检查位于 GET /healthz： us-govdata-mcp --http 3000（或设置 MCP_HTTP_PORT=3000）

环境变量

工作原理

每个工具都会验证其参数（zod），构建 Actor 输入，并通过 Authorization: Bearer 标头（绝不放在 URL 中）使用您的令牌调用 Apify API 的 run-sync-get-dataset-items 端点。Actor 在您的账户下的 Apify 平台上运行，生成的数据集项直接作为工具结果返回。此服务器不保持任何状态，除了传递数据外，不会看到任何数据。

开发

npm install
npm test          # builds + runs the full smoke suite (introspection, tokenless
                  # error path, dry-run request construction, HTTP transport)

测试套件无需 Apify 账户和网络——它使用 APIFY_DRY_RUN=1。

相关资源

• Apify Store 上所有 CBLU Actor 的个人资料：https://apify.com/cblu

• Model Context Protocol：https://modelcontextprotocol.io

许可证

MIT © CBLU