内容
# GovToolsPro MCP 服务器
[](https://www.npmjs.com/package/govtoolspro-mcp-server)
[](https://registry.modelcontextprotocol.io/v0/servers?search=govtoolspro)
[](https://glama.ai/mcp/servers/smythmyke/govtoolspro-mcp-server)
[](https://smithery.ai/servers/smythmyke/govtoolspro-mcp-server)
[](LICENSE)
一个 [MCP](https://modelcontextprotocol.io) 服务器，为联邦承包商提供工作流工具——不是原始数据访问，而是决策：通过/不通过评分、现任情报、团队合作伙伴搜索、重新竞争预测、海军 NECO 查询、SAM.gov 招标检索和市场情报（劳动力价格、奖励模式、市场分析）。
它封装了实时 [GovToolsPro](https://govtoolspro.com) API。您需要提供 API 密钥；服务器代理您的调用。
## 工具
| 工具 | 费用 | 功能 |
|---|---|---|
| `balance` | 免费 | 信用余额 + 订阅状态。 |
| `get_solicitation` | 免费 | 公告 ID（或招标编号）→ 结构化的 SAM.gov 字段（NAICS、PSC、设置 aside、绩效地点、截止日期、联系人、附件链接）。工作流入口点。 |
| `score_go_no_go` | 免费 | 根据公司简介为招标评分通过/不通过（0–100），并检测硬性阻止器（CMMC、地理、设置 aside）。 |
| `find_incumbents` | 免费 | 通过 USAspending + FPDS 确定当前现任者，附带竞争信号和预期下一次奖励日期。 |
| `find_partners_near` | 免费 | 按绩效地点附近的合作伙伴/分包商排名。 |
| `predict_recompete` | 免费 | 通过 NAICS/PSC/州/价值发现即将到期的合同（重新竞争机会），并附带选项行使信号。 |
| `lookup_neco_data` | 免费 | 将海军 NECO（neco.navy.mil）招标解析为结构化字段。其他政府 MCP 没有此功能。 |
| `lookup_labor_rates` | 免费 | 为 NAICS/劳动类别基准联邦劳动率——GSA CALC 授予的上限率 + BLS OEWS 工资，并附带政府包装估算。 |
| `analyze_award_patterns` | 3 积分 | NAICS 中合同的奖励方式：奖励规模分布、竞争混合、投标强度、合同车辆、定价类型。 |
| `analyze_market` | 5 积分 | NAICS 的市场情报快照：5 年支出趋势、行业规模、顶级承包商 + HHI 集中度、设置 aside 混合、地理、合同车辆。 |
每个工具返回决策支持输出，并附有免责声明——在依赖结果之前，请与官方招标核实。积分从共享的 GovToolsPro 池中扣除（扩展 + API + 连接器均计费相同的余额）；免费工具永远不会扣除。
## 安装
将以下内容添加到您的 MCP 客户端配置（Claude Desktop、Claude Code、Cursor、Cline、Zed 等）：
```jsonc
{
"mcpServers": {
"govtoolspro": {
"command": "npx",
"args": ["-y", "govtoolspro-mcp-server"],
"env": { "GOVTOOLSPRO_API_KEY": "gtp_live_..." }
}
}
}
```
### 获取 API 密钥
在 **GovToolsPro 扩展 → 个人资料 → API 密钥** 标签中创建密钥（格式为 `gtp_live_...` / `gtp_test_...`）。
## 作为 Claude 连接器使用（远程 MCP）
不想在本地运行任何内容？GovToolsPro 也是一个托管的 **远程 MCP 服务器**，您可以将其作为连接器添加到 Claude 中——无需安装，无需 API 密钥，只需使用您的 GovToolsPro 帐户登录。
- **远程 MCP URL：** `https://mcp.govtoolspro.com/api/mcp`
- 在 Claude 中：**设置 → 连接器 → 添加自定义连接器**，粘贴 URL，并将 OAuth 字段留空（服务器通过动态客户端注册自行注册）。
- 您将被发送到 **`auth.govtoolspro.com`** 登录；然后 Claude 通过 OAuth 2.1 连接。 在对话中切换连接器 **开启** 以使用其工具。
与扩展程序和 stdio 包使用的相同 10 个工具可通过连接器使用，并计费到相同的共享信用余额中。
## 配置
| 环境变量 | 必需 | 默认值 |
|---|---|---|
| `GOVTOOLSPRO_API_KEY` | 是 | — |
| `GOVTOOLSPRO_API_BASE` | 否 | `https://mcp.govtoolspro.com/api/v1/workflows` |
## 本地开发
```bash
npm install
npm run build
# 针对实时 API 进行端到端 stdio 烟雾测试
GOVTOOLSPRO_API_KEY=gtp_test_... npm run smoke
```
要将客户端指向本地构建：
```jsonc
{
"command": "node",
"args": ["/absolute/path/to/govtoolspro-mcp-server/dist/index.js"],
"env": { "GOVTOOLSPRO_API_KEY": "gtp_test_..." }
}
```
## 注意事项
- **工作流 MCP，而非数据包装器。** 竞争性政府 MCP 返回原始 SAM.gov/FPDS JSON；这些工具返回综合决策。
- **CUI 安全。** API 拒绝包含 CUI / FOUO / 分发声明标记的内容；这些拒绝作为明确错误返回给客户端。 请勿提交受控内容。
- **无担保。** 输出仅为决策支持——不是法律、合同或奖励结果建议。
## 故障排除
| 症状 | 原因/解决方法 |
|---|---|
| **`积分不足` / 402** | 三种工具需付费（`analyze_market` 5，`analyze_award_patterns` 3）。检查 `balance` 或在 [govtoolspro.com](https://govtoolspro.com) 充值。免费工具永远不会扣除。 |
| **连接器不断要求您登录 / 401** | 远程连接器需要 OAuth — 在 `auth.govtoolspro.com` 完成登录，然后在对话中切换连接器 **开启** （“搜索和工具”）。 |
| **`该 NAICS 无数据` （502）** | 该 NAICS 在窗口中没有联邦活动——**您不计费**。尝试更广泛的 NAICS 或更少的过滤器。 |
| **CUI 拒绝错误** | API 拒绝标记为 CUI / FOUO / 分发声明的内容。删除受控内容并重试。 |
| **`get_solicitation` 返回空值** | 使用来自 `sam.gov/opp/<id>/view` URL 的 32 个字符的公告 ID。一些存档/取消的公告可能不可用。 |
| **无效 API 密钥（stdio）** | 确保 `GOVTOOLSPRO_API_KEY` 是来自扩展程序的 **个人资料 → API 密钥** 标签的 `gtp_live_…` / `gtp_test_…` 密钥。 |
## 许可证
MIT © Michael Smyth
