捕获-MCP-服务器

Name: 捕获-MCP-服务器
Author: blencorp

作者：blencorp8 星标更新：2025-11-03

安装使用来源：spider==github.com

项目介绍

Capture MCP Server

一个MIT许可的、AI原生的模型上下文协议（MCP）服务器，集成SAM.gov、USASpending.gov和Tango API，通过自然语言查询捕获和分析联邦采购和支出数据。响应包括可读文本和结构化JSON，以便MCP兼容客户端可以程序化地消费数据。

概述

Capture MCP使用户能够通过像Claude Desktop这样的LLM应用程序捕获和查询联邦实体、机会和支出数据。它提供了15个专门工具，可以从多个政府API中搜索、分析和连接数据。

兼容性：Claude Desktop、ChatGPT Desktop（Pro+）以及任何MCP兼容客户端

功能

结构化输出 – 每个工具调用返回JSON和描述性文本，以实现最佳客户端兼容性。
安全速率限制 – 基于队列的节流防止在SAM.gov、USASpending.gov和Tango API上意外超出配额。
输入卫生 – 参数净化剥离控制字符，同时保留有意义的标点符号。

USASpending.gov 集成（4个工具 - 不需要API密钥）

get_usaspending_awards - 机构奖励摘要
get_usaspending_spending_by_category - 支出分解
get_usaspending_budgetary_resources - 预算信息
search_usaspending_awards_by_recipient - 根据公司查找奖励

SAM.gov 集成（4个工具 - 需要SAM.gov API密钥）

search_sam_entities - 查找联邦承包商和企业
get_sam_opportunities - 发现合同机会
get_sam_entity_details - 获取全面的企业概况
check_sam_exclusions - 验证承包商资格

数据连接（2个工具 - 需要SAM.gov API密钥）

get_entity_and_awards - 结合SAM实体数据与支出历史
get_opportunity_spending_context - 将机会与市场背景联系起来

Tango API 集成（5个工具 - 需要Tango API密钥）

search_tango_contracts - 通过统一API搜索联邦合同
search_tango_grants - 搜索联邦拨款和财政援助
get_tango_vendor_profile - 获取包含历史记录的供应商概况
search_tango_opportunities - 搜索带有预测的合同机会
get_tango_spending_summary - 获取支出摘要和分析

工具可用性矩阵

服务器根据提供的API密钥自动启用工具：

提供的API密钥	启用的工具集	总工具数
无（开箱即用）	USASpending.gov	4个工具
只有 `SAM_GOV_API_KEY`	SAM.gov + USASpending.gov + 连接工具	10个工具
只有 `TANGO_API_KEY`	Tango API + USASpending.gov	9个工具
两个密钥	所有工具集	1_5个工具

快速开始

先决条件

Node.js 18+（包含在Claude Desktop中用于.mcpb安装）
Claude Desktop 或 ChatGPT Desktop（Pro/Plus/Business/Enterprise/Education）
API密钥（可选 - 请参阅API密钥部分）：
- 不需要密钥：4个USASpending.gov工具立即可用
- SAM.gov API密钥：增加6个工具（总计10个）
- Tango API密钥：增加5个工具（总计9个）
- 两个密钥：所有15个工具

选择您的安装方法

对于Claude Desktop用户：使用方法1：一键安装进行最简单的设置，具有图形化的API密钥配置界面。

对于ChatGPT Desktop或其他MCP客户端：使用方法2：标准MCP配置，该方法适用于所有MCP兼容的应用程序。

安装方法

方法1：一键安装（Claude Desktop）

桌面扩展（.mcpb文件）为Claude Desktop用户提供最简单的安装体验。无需终端、配置文件或依赖冲突。

什么是桌面扩展？

.mcpb文件是一个捆绑的MCP服务器包（类似于Chrome扩展或VS Code扩展），其中包含：

完整的MCP服务器代码
所有预安装的依赖项
配置元数据和品牌
API密钥安装提示

安装步骤

步骤1：构建扩展包

# 克隆仓库
git clone https://github.com/blencorp/capture-mcp-server.git
cd capture-mcp-server

# 安装依赖项
npm install

# 创建.mcpb包
npm run package

这将在当前目录创建capture-mcp-server.mcpb（约4.2MB）。

步骤2：在Claude Desktop中安装

选项A：双击安装

定位到capture-mcp-server.mcpb文件
双击文件以使用Claude Desktop打开
在安装对话框中点击“安装”

选项B：设置安装

打开Claude Desktop
转到设置 → 扩展（或开发者 → 编辑配置）
点击“安装扩展...”或将.mcpb文件拖放到设置窗口中
当提示时点击“安装”

步骤3：配置API密钥（可选）

在安装期间或之后，Claude Desktop会提示您配置API密钥：

跳过所有密钥：不输入密钥点击“继续” → 立即可用4个USASpending.gov工具
输入一个密钥：提供SAM.gov或Tango密钥 → 可用9-10个工具
输入两个密钥：提供两个密钥 → 可用所有15个工具

您可以通过设置 → 扩展 → Capture MCP Server → 配置稍后添加或更新API密钥。

步骤4：验证安装

重新启动Claude Desktop
打开设置 → 扩展（或开发者 → MCP服务器）
验证“Capture MCP Server”显示为“已连接”
开始新的对话并询问：“Capture MCP Server有哪些可用工具？”

关于.mcpb安装的重要注意事项

兼容性警告：.mcpb格式要求Claude Desktop版本1.0.0或更高。如果您看到错误如“此扩展需要更新Claude Desktop”或“未识别的键”，请：

更新Claude Desktop到最新版本，或者
使用方法2：标准MCP配置代替

为什么是Node.js？ 此服务器使用Node.js构建，因为Claude Desktop在macOS和Windows上捆绑了Node.js，这意味着扩展可以立即工作，而无需用户安装Python或其他运行时环境。

方法2：标准MCP配置（推荐）

标准MCP配置是最可靠的方法，并且适用于所有MCP客户端，包括Claude Desktop、ChatGPT Desktop和自定义实现。

步骤1：克隆和构建

# 克隆仓库
git clone https://github.com/blencorp/capture-mcp-server.git
cd capture-mcp-server

# 安装依赖项
npm install

# 构建TypeScript到JavaScript
npm run build

这将在dist/目录中创建编译后的JavaScript文件。

步骤2：定位您的MCP配置文件

Claude Desktop（macOS）：

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop（Windows）：

%APPDATA%\Claude\claude_desktop_config.json

ChatGPT Desktop（macOS）：

~/Library/Application Support/ChatGPT/mcp_config.json

ChatGPT Desktop（Windows）：

%APPDATA%\ChatGPT\mcp_config.json

注意：对于ChatGPT Desktop，您需要Pro、Plus、Business、Enterprise或Education订阅。检查设置 → Beta功能 → 开发者模式以启用MCP支持。

步骤3：添加服务器配置

打开您的MCP配置文件并添加Capture MCP Server配置。根据您拥有的API密钥选择适当的配置：

配置A：无API密钥（4个USASpending.gov工具）

{
  "mcpServers": {
    "capture-mcp-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/capture-mcp-server/dist/server.js"]
    }
  }
}

配置B：只有SAM.gov API密钥（10个工具）

{
  "mcpServers": {
    "capture-mcp-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/capture-mcp-server/dist/server.js"],
      "env": {
        "SAM_GOV_API_KEY": "your-sam-api-key-here"
      }
    }
  }
}

配置C：只有Tango API密钥（9个工具）

{
  "mcpServers": {
    "capture-mcp-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/capture-mcp-server/dist/server.js"],
     _ "env": {
        "TANGO_API_KEY": "your-tango-api-key-here"
      }
    }
  }
}

配置D：两个API密钥（所有15个工具）

{
  "mcpServers": {
    "capture-mcp-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/capture-mcp-server/dist/server.js"],
      "env": {
        "SAM_GOV_API_KEY": "your-sam-api-key-here",
        "TANGO_API_KEY": "your-tango-api-key-here"
      }
    }
  }
}

关键：将/ABSOLUTE/PATH/TO/capture-mcp-server替换为您实际克隆存储库的位置。

示例：

macOS：/Users/yourname/projects/capture-mcp-server
Windows：C:\Users\yourname\projects\capture-mcp-server

步骤4：重启您的MCP客户端

Claude Desktop：完全退出（macOS上的Cmd+Q）然后重新打开
ChatGPT Desktop：完全退出然后重新打开

步骤5：验证安装

在Claude Desktop中：

打开设置 → 开发者 → MCP服务器
查找“capture-mcp-server”状态为“已连接”

在ChatGPT Desktop中：

打开设置 → Beta功能 → 开发者模式
检查MCP服务器部分显示“capture-mcp-server”为“已连接”

测试连接：在新对话中询问：“列出Capture MCP Server的所有可用工具”

您应该看到根据您的API密钥配置列出4-15个工具。

API密钥

为什么API密钥是可选的？

此服务器设计考虑了灵活性：

USASpending.gov 提供了一个不需要身份验证的公共API
SAM.gov 和 Tango 需要API密钥才能访问其数据

您可以立即使用4个USASpending.gov工具，然后稍后添加API密钥以解锁更多功能。

如何获取API密钥

SAM.gov API密钥（启用6个额外工具）

获取时间：激活大约需要24小时

创建SAM.gov账户：
- 访问 https://sam.gov/content/home
- 点击“登录” → “创建账户”
- 完成注册并验证电子邮件
请求API访问：
- 登录到SAM.gov
- 导航至 https://sam.gov/data-services/API
- 点击“请求公共API密钥”
- 接受条款和条件
检索您的API密钥：
- API密钥将发送到您的注册邮箱
- 密钥可能需要最多24小时才能激活
- 密钥与您的SAM.gov账户相关联
API密钥详情：
- 格式：64个字符的字母数字字符串
- 速率限制：每个端点不同（通常每天1,000-10,000次请求）
- 费用：免费
- 文档：https://open.gsa.gov/api/entity-api/

启用这些工具：

4个SAM.gov工具（实体、机会、详细信息、排除）
2个连接工具（实体+奖励，机会+背景）

Tango API密钥（启用5个额外工具）

获取时间：批准后立即获得

访问Tango网站：
- 前往 https://tango.makegov.com
请求访问：
- 点击“获取API访问权限”或“注册”
- 填写请求表单
- 提供用例细节
接收API密钥：
- 账户批准后提供API密钥
- 对于已批准的用户通常是即时的
API密钥详情：
- 格式：可变长度字符串
- 速率限制：查看您的账户仪表板
- 费用：查看定价 https://tango.makegov.com/pricing
- 文档：https://tango.makegov.com/docs/

启用这些工具：

5个Tango工具（合同、拨款、供应商概况、机会、支出摘要）

管理API密钥

标准MCP配置

编辑您的MCP配置文件并在env部分更新您的密钥。更新后重启客户端。

桌面扩展（.mcpb）

打开Claude Desktop → 设置 → 扩展
点击“Capture MCP Server”
点击“配置”
更新API密钥字段
点击“保存”
Claude Desktop将自动重新启动服务器

安全说明：两种方法都安全地存储API密钥：

标准配置：存储在您的本地配置文件中（仅您可访问）
桌面扩展：存储在操作系统密钥链中（macOS/Windows凭据管理器）

测试与验证

快速测试查询

安装后，通过询问以下问题来测试您的服务器是否正常工作：

无API密钥测试（USASpending.gov工具）

使用Capture MCP Server，获取类别为075（卫生与公共服务部）的支出分解
对于财政年度2024

SAM.gov工具测试（需要SAM_GOV_API_KEY）

使用SAM工具，搜索加利福尼亚州从事NAICS代码541512（计算机系统设计服务）的实体

Tango工具测试（需要TANGO_API_KEY）

使用Tango，搜索最近的联邦可再生能源拨款

连接工具测试（需要SAM_GOV_API_KEY）

使用连接工具，获取UEI为KAR6JDB1HJ16的SAM实体详细信息和奖励历史

使用MCP Inspector

MCP Inspector提供了一个基于Web的调试界面，无需Claude Desktop或ChatGPT即可测试工具。

步骤1：安装MCP Inspector

npm install -g @modelcontextprotocol/inspector

步骤2：启动带有Inspector的服务器

npx @modelcontextprotocol/inspector node dist/server.js

步骤3：打开Web界面

导航到http://localhost:5173。

步骤4：配置API密钥（可选）

点击“环境”标签
添加环境变量：
- SAM_GOV_API_KEY：your-key-here
- TANGO_API_KEY：your-key-here
重新启动Inspector

步骤5：测试工具

查看可用工具（根据API密钥4-15个）
点击工具查看其架构
填写参数并点击“执行”
查看响应并调试任何问题

Inspector特别适用于：

测试新工具实现
调试API集成问题
理解工具参数和响应
无需Claude Desktop即可展示功能

故障排除

服务器无法启动

症状：服务器未出现在客户端或显示为“断开连接”

解决方案：

验证构建：
```
cd /path/to/capture-mcp-server
npm run build
```
确保构建完成没有错误。
检查Node.js版本：
```
node --version
```
必须≥18.0.0。如有必要，请更新Node.js。