govcontractscout-mcp

GovContractScout MCP 服务

Model Context Protocol（MCP）服务，向 AI Agent 提供 GovContractScout 美国州、地方和联邦政府合同 API。搜索实时合同、获取详细信息、查询 NAICS 编码、列出州并评估合同匹配度——无需处理原始 HTTP。

AI agent (Claude, Cursor, etc.)  ⇄  MCP  ⇄  GovContractScout /v1 API  ⇄  50-state procurement data

工具

工具	描述
search_contracts	按州、NAICS、关键词搜索有效政府合同（返回标题、机构、截止日期和匹配信号）
get_contract	按 ID 获取单份合同的完整记录（包括原始招标链接和文档）
search_naics	按关键词查询 NAICS 编码
get_states	列出已建立索引的州及实时合同数量
score_contract	根据企业资料评估合同匹配度（使用 /v1/match）
win_likelihood	根据历史获奖类型估算中标概率——衍生数据，付费
archetypes	列出获奖企业类型——谁赢得了什么——衍生数据，付费

所有工具都调用与公共 REST 端点相同的 /v1 API——数据、身份验证和速率限制均相同。数据来自州采购门户，每日更新。

托管端点（无需安装）

此外还提供远程服务 https://scout.govbidportals.com/mcp——采用 Streamable HTTP，协议版本为 2025-06-18，无需安装。它提供上述所有功能，另含 get_profile（共 8 个工具）。

有两种身份验证方式：

1. OAuth 2.1——支持此方式的客户端可自行连接。401 挑战会指向 https://scout.govbidportals.com/.well-known/oauth-protected-resource，随后登录并关联账户。
2. API 密钥标头——只发送固定标头的客户端可以传入与 REST API 相同的 gcs_live_... 密钥：

curl -X POST https://scout.govbidportals.com/mcp \
  -H "Authorization: Bearer gcs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-agent","version":"1"}}}'

这两种凭据的套餐、配额和速率限制均与本地使用的密钥相同。

要求

• Node.js 18+
• GovContractScout API 密钥（gcs_live_...）——免费套餐可用（每月 100 次调用）；生产环境可使用付费套餐。**付费套餐无需账户：**在 scout.govbidportals.com/docs/api#pricing 购买，结账时密钥会发送到你的邮箱。免费套餐需要账户：scout.govbidportals.com/api-keys——即时开通，无需银行卡。

快速开始

Claude Code

claude mcp add govcontractscout \
  --env GCS_API_KEY=gcs_live_YOUR_KEY \
  -- npx -y govcontractscout-mcp

任意 MCP 客户端（mcp.json / mcp.settings）

{
  "mcpServers": {
    "govcontractscout": {
      "command": "npx",
      "args": ["-y", "govcontractscout-mcp"],
      "env": {
        "GCS_API_KEY": "gcs_live_YOUR_KEY"
      }
    }
  }
}

手动（从源代码开始）

npm install && npm run build
GCS_API_KEY=gcs_live_YOUR_KEY node dist/index.js

配置

变量	必需	默认值	描述
GCS_API_KEY	✅	—	你在控制面板获取的 API 密钥
GOVCONTRACTSCOUT_API_BASE	❌	https://scout.govbidportals.com	API 基础 URL 覆盖值（用于自托管）

示例

向你的 Agent 提问：

“查找加利福尼亚州本月到期的开放 IT 服务合同，然后评估最匹配的一份合同是否适合一家拥有 10 名员工且具备 T&M 经验的咨询公司。”

Agent 会调用 search_contracts（state=CA，naics=IT services），然后调用 score_contract——Agent 无需了解 HTTP。

设计说明

• 幂等评分 — score_contract 会发送确定性的 Idempotency-Key，因此重试不会重复消耗配额。
• 与 API 相同的竞争壁垒 — 列表和搜索结果会有意排除源 URL 和原始 source_portal 字段（这是聚合形成的竞争壁垒）；get_contract 详情包含原始招标链接，与 API 完全一致。MCP 暴露的内容与 API 相同。
• 如实说明覆盖范围 — 合同带有 data_quality 字段（级别及已填充的字段）。部分州的数据比其他州更丰富；API 会准确告知你能获取哪些数据。

API / 定价

• 免费：每月 100 次调用，需要账户
• 付费：无需账户 — 在 scout.govbidportals.com/docs/api#pricing 购买；结账后会通过电子邮件发送密钥
• Starter 每月 $99 · Growth 每月 $199 · 年付 = 17% 折扣
• win_likelihood 和 archetypes 属于付费套餐（Starter+） — 衍生数据层
• 完整 API 文档：scout.govbidportals.com/docs/api

开发

npm run dev    # tsx watch
npm run build  # tsc -> dist/
npm start      # run built server

该服务是公共 REST API（/v1/contracts、/v1/contracts/:id、/v1/naics、/v1/states、/v1/match）的轻量封装 — 模式请参阅 API 文档。

许可证

MIT