捕获MCP服务器

麻省理工学院许可的人工智能原生模型上下文协议（MCP）服务器，集成了SAM.gov、USASpending.gov和Tango API，通过自然语言查询捕获和分析联邦采购和支出数据。响应包括人类可读的文本和结构化的JSON，因此兼容MCP的客户端可以以编程方式使用数据。

概述

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

兼容：克劳德桌面、ChatGPT桌面（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工具
两把钥匙	所有工具集	15工具

快速开始

先决条件

Node.js 18+ （包含在用于.mcpb安装的Claude Desktop中）
克劳德桌面版 或 ChatGPT桌面 （专业/专业/商业/企业/教育）
API密钥 （可选-请参阅 API密钥部分）：

- 无需：4个USASpending.gov工具立即工作 - SAM.gov API密钥：增加6个工具（共10个） - Tango API键：增加5个工具（共9个） - 两把钥匙：全部15个工具

选择您的安装方法

适用于Claude Desktop用户：使用方法1：一键安装使用图形API键配置界面进行最简单的设置。

适用于ChatGPT桌面或其他MCP客户端：使用方法2：标准MCP配置其在所有MCP兼容应用中普遍工作。

用于托管您自己的服务：使用方法3：托管版本（AWS无服务器）在AWS上为您的组织部署共享的Capture MCP服务。

安装方法

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

桌面扩展 (.mcpb 文件）为Claude Desktop用户提供最简单的安装体验。没有终端，没有配置文件，没有依赖冲突。

什么是桌面扩展？

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

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

安装步骤

步骤1：构建扩展包

# Clone the repository
git clone https://github.com/blencorp/capture-mcp-server.git
cd capture-mcp-server

# Install dependencies
npm install

# Create the .mcpb package
npm run package

这创造了 capture-mcp-server.mcpb （~4.2MB）在当前目录中。

步骤2：在Claude Desktop中安装

选项A：双击安装

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

选项B：设置安装

打开克劳德桌面
首选设置 → 扩展（或 开发者 → 编辑配置)
点击“安装扩展…”或拖动 .mcpb 将文件放入设置窗口
出现提示时单击“安装”

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

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

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

您可以稍后通过添加或更新API密钥设置 → 扩展 → 捕获MCP服务器 → 配置.

步骤4：验证安装

重新启动克劳德桌面
打开设置→ 扩展（或开发人员→ MCP服务器）
验证“捕获MCP服务器”是否显示为“已连接”
开始新的对话并问： *“Capture MCP Server提供了哪些工具？”*

.mcpb安装的重要注意事项

兼容性警告：The .mcpb 格式要求Claude Desktop v1.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：克隆和构建

# Clone the repository
git clone https://github.com/blencorp/capture-mcp-server.git
cd capture-mcp-server

# Install dependencies
npm install

# Build TypeScript to JavaScript
npm run build

这将在 dist/ 目录。

步骤2：找到MCP配置文件

克劳德桌面（macOS）:

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

克劳德桌面（Windows）:

%APPDATA%\Claude\claude_desktop_config.json

ChatGPT桌面（macOS）:

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

ChatGPT桌面（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
窗户： C:\Users\yourname\projects\capture-mcp-server

步骤4：重新启动MCP客户端

克劳德桌面版：完全退出（macOS上的Cmd+Q）并重新打开
ChatGPT桌面：完全退出并重新打开

步骤5：验证安装

在克劳德桌面:

打开设置→ 开发者→ MCP服务器
查找状态为“已连接”的“捕获mcp服务器”

在ChatGPT桌面中:

打开设置→ Beta功能→ 开发人员模式
检查MCP服务器部分显示“捕获MCP服务器”为“已连接”

测试连接: 在新对话中提问： *“列出Capture MCP服务器中的所有可用工具”*

您应该看到列出的4-15个工具，具体取决于您的API密钥配置。

方法3：托管版本（AWS无服务器）

在AWS上为您的组织部署共享的Capture MCP服务。部署一次，然后创建API密钥(cap_xxx...)分发给您的用户。无服务器架构的成本约为每月1-11美元，并且可以自动扩展。

建筑

┌──────────────┐     ┌─────────────────┐     ┌──────────────┐
│  MCP Client  │────▶│  API Gateway    │────▶│    Lambda    │
│              │     │  (HTTP API)     │     │ (MCP Handler)│
└──────────────┘     └─────────────────┘     └──────┬───────┘
                                                    │
                     ┌─────────────────┐            │
                     │   S3 Bucket     │◀───────────┘
                     │  (API Keys)     │   (HeadObject for auth)
                     └─────────────────┘

先决条件

AWS帐户 具有Lambda、API网关、S3、CloudFormation和IAM的权限
AWS-CLI 已安装并配置(安装指南)
Node.js 20.x 或以后
AWS-CDK-CLI: npm install -g aws-cdk

AWS凭据设置

在部署之前，请确保您的AWS凭据已配置。CDK使用与AWS CLI相同的凭据解析。

选项1：默认配置文件

aws configure
# Enter your Access Key ID, Secret Access Key, and default region (e.g., us-east-1)

选项2：命名配置文件

aws configure --profile my-profile
export AWS_PROFILE=my-profile

选项3：环境变量

export AWS_ACCESS_KEY_ID=your-access-key
export AWS_SECRET_ACCESS_KEY=your-secret-key
export AWS_REGION=us-east-1

验证您的凭据是否正常工作：

aws sts get-caller-identity

步骤1：部署到AWS

# Install CDK dependencies
cd infrastructure
npm install
cd ..

# Bootstrap CDK (first time only per account/region)
npm run cdk:bootstrap

# Build and deploy (requires manual approval for security-sensitive changes)
npm run cdk:deploy

# Or skip approval prompts entirely (use with caution)
npm run cdk:deploy:yolo

部署选项:

npm run cdk:deploy --在创建/更新IAM角色、安全组或其他敏感资源之前，提示手动批准。推荐用于生产。
npm run cdk:deploy:yolo --跳过所有审批提示(--require-approval never).开发/测试速度更快，但在生产中要谨慎使用。

什么是CDK Bootstrap？ 首次将CDK应用程序部署到AWS帐户/地区时，您需要配置CDK使用的初始资源（资产的S3存储桶、IAM角色等）。这是一次性设置。了解更多： CDK自举

# Verify deployment succeeded - check the health endpoint
curl https:///health

步骤2：同步配置

部署后，运行 sync-config 读取CloudFormation堆栈输出并将其保存在本地：

npm run sync-config

这创造了 .capture-mcp.json （gitignored）包含部署的bucket名称、端点URL和区域。 这是必需的 然后才能管理API密钥或构建托管扩展包。

步骤3：为用户创建API密钥

现在为每个需要访问的用户创建API密钥：

# Create a key that never expires
npm run manage-keys -- create --owner "John Doe"

# Create a key with an expiration date
npm run manage-keys -- create --owner "Jane Smith" --expires "2025-12-31"

重要：立即保存生成的密钥！它只显示一次，以后无法检索。为了安全起见，密钥在S3中存储为SHA-256哈希值。

密钥管理命令:

npm run manage-keys -- list              # List all keys with owner and status
npm run manage-keys -- verify       # Check if a specific key is valid
npm run manage-keys -- revoke       # Revoke a key (by key or hash prefix)

步骤4：构建托管扩展包

创建 .mcpb 使用您的端点URL预先配置的文件，用户只需单击一下即可安装：

npm run package:hosted

这创造了 capture-mcp-server-hosted.mcpb 包含：

您的MCP端点URL（来自同步配置）
安装过程中提示输入API密钥
所有元数据和品牌

步骤5：分发给用户

选项A：提供 .mcpb 文件（推荐）

向用户发送 capture-mcp-server-hosted.mcpb 文件及其API密钥。安装方式：

双击 .mcpb 要在Claude Desktop中打开的文件
输入其API密钥(cap_xxx...)当系统提示时
可选择输入他们自己的SAM.gov或Tango API密钥以获得其他工具
单击安装

选项B：手动配置

对于喜欢手动设置的用户，请提供：

您的MCP端点URL（来自部署输出）
他们的个人API密钥(cap_xxx...)

他们将此添加到他们的Claude Desktop配置中(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "capture-hosted": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.1.31",
        "https://YOUR-MCP-ENDPOINT/mcp",
        "--header",
        "X-Api-Key:cap_xxx..."
      ]
    }
  }
}

用户可以添加自己的SAM.gov/Tango密钥 --header 论据。

成本估算

使用级别	请求数/月	估计成本
低	10万	~1.11美元/月
中等	1百万	~11美元/月

测试您的部署

# List available tools via curl
curl -X POST https:///mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-Api-Key: cap_your_api_key_here" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

自定义域（可选）

如果您的域名是作为 Route53托管区，CDK将自动：

创建ACM证书
通过DNS验证（Route53）
在API网关中创建自定义域
创建指向API网关自定义域的A记录

设置：

创建 .env 项目根目录中的文件（复制自 .env.example):

   # .env
   AWS_REGION=us-east-1
   AWS_ACCOUNT=123456789012
   DOMAIN_NAME=mcp.example.com

使用自定义域进行部署：

   npm run cdk:deploy

需求要求 mcp.example.com规格 mcp.example.com：域必须作为Route53中的托管区域存在。对于

，Route53必须有一个托管区域

npm run cdk:deploy  # Rebuilds and deploys automatically

更新部署

要在代码更改后进行更新，请执行以下操作：

npm run cdk:test

测试基础设施

CDK堆栈包括用于验证资源配置的全面测试：

测试包括S3存储桶安全设置、Lambda配置、API网关路由和CORS、IAM权限、CloudWatch日志保留、堆栈输出和特定于环境的行为（dev与prod）。

# Prompts for confirmation before destroying
npm run cdk:destroy

# Or skip confirmation prompt entirely
npm run cdk:destroy:yolo

销毁堆栈要删除所有AWS资源，请执行以下操作：

npm run cdk:destroy 销毁选项
npm run cdk:destroy:yolo :--force--删除资源前提示确认。建议防止意外删除。

--跳过确认().适用于自动拆卸或您确定的情况。

备注

：默认情况下保留S3存储桶以保留API密钥。如果需要，请手动删除它。监控 /aws/lambda/capture-mcp-server CloudWatch日志
:（保留1个月） AWS/Lambda/Invocations关键指标 AWS/Lambda/Duration: AWS/Lambda/Errors
,, CaptureMCP/MCPRequestLatency

自定义指标

:安全须知
API密钥：存储为SHA-256哈希值——原始密钥从未持久化
S3铲斗：所有公共访问被阻止，强制使用SSL
Lambda IAM：最低权限（S3只读）

仅限HTTPS

：通过API网关加密的所有流量故障排除 |问题|解决方案| npm run cdk:bootstrap |---------|----------| |CDK部署失败，出现引导错误|运行 X-Api-Key | |“需要API密钥”（401）|包括 npm run manage-keys -- verify 头球 |“无效的API密钥”（401）|使用验证密钥 aws sts get-caller-identity | |AWS凭据错误|运行

验证凭据|

|Lambda超时|检查CloudWatch日志；一些外部API可能很慢|

API密钥

为什么API密钥是可选的？ 此服务器的设计考虑了灵活性：
美国Spending.gov 提供了一个不需要身份验证的公共API SAM.gov 和

探戈

需要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个字符的字母数字字符串 - 速率限制：因端点而异（通常为1000-10000个请求/天） - 成本：免费

文档: 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密钥 env 标准MCP配置

编辑MCP配置文件并更新

用你的钥匙。更新后重新启动客户端。
桌面扩展（.mcpb）
打开克劳德桌面→ 设置→ 扩展
点击“捕获MCP服务器”
点击“配置”
更新API关键字段

点击“保存”Claude Desktop将自动重启服务器

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

标准配置：存储在本地配置文件中（仅供您访问）

桌面扩展：存储在OS钥匙链中（macOS/Windows凭据管理器）

测试与验证

快速测试查询

Using the Capture MCP Server, get the spending breakdown by category
for agency code 075 (Department of Health and Human Services) for
fiscal year 2024

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

Using the SAM tools, search for entities in California that work
in NAICS code 541512 (computer systems design services)

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

Using Tango, search for recent federal grants in renewable energy

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

Using the join tools, get both SAM entity details and award history
for UEI: KAR6JDB1HJ16

测试探戈工具（需要Tango_API_KEY）

测试加入工具（需要SAM_GOV_API_KEY）使用MCP检查器这

MCP检查员

npm install -g @modelcontextprotocol/inspector

为没有Claude Desktop或ChatGPT的测试工具提供了一个基于web的调试界面。

npx @modelcontextprotocol/inspector node dist/server.js

步骤1：安装MCP检查器

步骤2：使用检查器启动服务器

步骤3：打开Web界面

导航到http://localhost:5173在您的浏览器中。
步骤4：配置API密钥（可选）

- SAM_GOV_API_KEY点击“环境”选项卡 - TANGO_API_KEY添加环境变量：

：你的钥匙在这里

：你的钥匙在这里

重新启动检查器
步骤5：测试工具
查看可用的工具（4-15取决于API键）
单击工具查看其架构

填写参数，点击“执行”

查看响应并调试任何问题
检查员在以下方面特别有用：
测试新工具实现
调试API集成问题

了解工具参数和响应

在没有Claude Desktop的情况下演示功能

故障排除服务器无法启动

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

解决方案:

   cd /path/to/capture-mcp-server
   npm run build

验证构建

:确保构建无错误地完成。

   node --version

检查Node.js版本

:必须≥18.0.0。如果需要，更新Node.js。

- 验证绝对路径 - : / 打开MCP配置文件 C:\ 确保路径以开头 - （macOS/Linux）或 ~ （Windows） - 路径不应使用 ./dist/server.js或环境变量

路径不应该是相对的（例如。，)

- 检查拼写错误 dist/server.js : - 验证

存在于指定路径检查JSON语法（没有尾随逗号，匹配大括号）

- 完全重新启动客户端 - :

完全退出应用程序（而不仅仅是关闭窗口）重新打开并检查连接状态

- 检查客户端日志: - 克劳德桌面版：设置→ 开发者→ 查看日志 - ChatGPT桌面

：检查应用程序日志

查找与“捕获mcp服务器”相关的错误消息未显示任何工具

症状：服务器已连接，但没有可见的工具

解决方案 :

- 验证API密钥 - （如果使用它们）： - 检查API密钥值中的打字错误

确保没有多余的空格或引号验证密钥是否处于活动状态（SAM.gov密钥需要24小时才能激活）

- 确认最小工具集 - :

如果没有任何键，您应该看到4个USASpending.gov工具如果您看到0个工具，则表示服务器加载不正确

   npx @modelcontextprotocol/inspector node dist/server.js

检验员测试

:这将准确显示正在加载的工具和任何错误。

启用调试模式

   "env": {
     "DEBUG": "true"
   }

添加到您的env配置中：

检查日志以获取详细的错误消息。桌面扩展（.mcpb）安装问题

症状：“此扩展需要更新Claude Desktop”或“无法识别的密钥” .mcpb 解释

：The格式规范已经发展。某些版本的Claude Desktop可能支持不同的清单版本。

解决方案 :

- 更新克劳德桌面 - （推荐）： - 检查更新：设置→ About

更新到最新版本 尝试重新安装.mcpb

- 使用标准MCP配置 - （始终有效）：跳过.mcpb安装 - 使用

方法2：标准MCP配置标准配置更可靠，适用于所有客户端

验证清单版本 manifest.json:

   "manifest_version": "0.2"

如果你是从源代码构建的，请检查 "0.2" : "0.3"

某些Claude Desktop版本需要而不是

   npm run build
   npm run package

重建包

:尝试安装新构建的.mcpb文件。

检查图标文件 icon.png :

确保

存在于根目录中（不在子目录中）。API关键问题

症状：需要API密钥的工具返回错误，如“未授权”或“无效的API密钥”

解决方案:

验证密钥有效性

   curl "https://api.sam.gov/entity-information/v3/entities?api_key=YOUR_KEY&limit=1"

测试您的SAM.gov API密钥：应该返回JSON数据，而不是错误。

- 检查SAM.gov密钥激活 - :

SAM.gov密钥创建后可能需要24小时才能激活如果密钥是新创建的，请稍候，稍后重试

- 删除额外字符 - : - API键不应有空格、引号或换行符 "SAM_GOV_API_KEY": "abc123..."

小心地从源复制密钥在JSON配置中，key应该在引号内：

- 验证密钥权限 - :

登录SAM.gov查看API密钥状态确保密钥已启用必要的权限

- 使用MCP检查员进行测试 - :

使用Inspector直接测试API调用

查看API的确切错误消息ChatGPT桌面问题

症状：ChatGPT桌面中的“MCP不可用”

解决方案:

- 验证订阅 - :

需要Pro、Plus、Business、Enterprise或Education订阅免费套餐不支持MCP

- 启用开发人员模式 - :

设置→ Beta功能打开“开发人员模式”

- 检查ChatGPT版本 - :

要求ChatGPT桌面≥1.2025.x（2025年9月以上）需要时更新：帮助→ 检查更新

- 使用正确的配置文件 mcp_config.json : claude_desktop_config.json必须 - （不是 ~/Library/Application Support/ChatGPT/mcp_config.json

)地点：

验证JSON结构

   {
     "mcpServers": {
       "capture-mcp-server": { ... }
     }
   }

:

ChatGPT使用与Claude Desktop相同的MCP配置格式：利率限制问题

症状：工具返回错误，如“请求太多”或“超出速率限制”

解决方案:

内置速率限制

- : - 此服务器包括自动速率限制： - SAM.gov：请求之间延迟100ms

USASpending.gov:3.6秒延迟（尊重~1000/小时限制）Tango:请求之间延迟100ms

- 降低查询频率 - : limit 避免快速查询 - 使用

用于减小结果大小的参数尽可能组合查询

- 检查API配额 - :

SAM.gov：检查密钥的每日限制Tango：检查您的帐户控制面板

- 等待并重试 - :

费率限制通常每小时或每天重置一次

请等待1小时，然后重试

查询示例

Find janitorial service contracts awarded to service-disabled
veteran-owned businesses in the past 6 months

What's the total federal spending on cybersecurity contracts
in fiscal year 2023?

List all 8(a) set-aside opportunities from federal agencies
posted in the last 30 days

安装后，您可以问自然语言问题。LLM将自动选择和使用适当的工具。

What was the total obligated spending by HHS (Department of Health
and Human Services) on cloud computing last fiscal year?

Show me recent contract awards for 'penetration testing'
under $250,000 by the Department of Defense

通用商业智能

Find the complete profile and award history for contractor with
UEI: ZQGGHJH74DW7

Search for all IT consulting companies registered in Virginia,
then analyze their federal contract history

机构特定查询

What are the active landscaping maintenance contracts in Florida?

Show me building maintenance and repair contracts over $100,000
awarded this year across all agencies

承包商研究

市场分析

Find all small business contractors in NAICS 541330 (engineering
services) in Texas, then get their spending history for 2023,
and identify the top 5 by total contract value

Search for HVAC maintenance opportunities posted this month,
then analyze historical spending patterns for those agencies
to identify the most active buyers

多工具查询

LLM可以自动将多个工具链接在一起：

API文档

工具参考

有关完整的API文档，包括所有参数、模式和示例，请参阅完整的工具说明： USASpending.gov工具（无需API密钥）
get_usaspending_awards -获取特定机构的联邦奖励数据
get_usaspending_spending_by_category -按类别分列的支出明细
获取_支出_预算_资源 -预算/债务信息

搜索_支出_支出_收件人_收件人

-按收件人姓名查找奖项 SAM.gov工具（需要SAM_gov_API_KEY）
search_sam_entities -搜索已注册的联邦承包商
get_sam_机会 -寻找合同机会
get_sam_entity_details -获取全面的实体资料

check_sam_排除项

-核实承包商资格状态 联接工具（需要SAM_GOV_API_KEY）
get_entity_and_awards -将SAM实体与美国支出历史相结合

获取机会_支出_文本

-将机会与支出数据联系起来 Tango API工具（需要Tango_API_KEY）
搜索_安哥拉_合同 -搜索联邦合同（统一的API）
搜索_安哥拉_赠款 -搜索联邦拨款
get_tang_vendor_profile -获取具有完整历史记录的供应商档案
搜索安哥拉机会 -用预测搜索机会

get_tango_spending_summary

-获取支出分析

速率限制此服务器实现自动速率限制以遵守API配额： |API |请求之间的延迟|每日限制|注释| |-----|----------------------|-------------|-------| | 美国Spending.gov |3.6秒|约1000次请求/小时|公共API| | SAM.gov |100ms |因按键而异|查看SAM.gov仪表板| |

探戈

|100ms |因计划而异|查看Tango仪表板|

{
  "error": "Error message description",
  "details": "Additional context if available"
}

错误处理

所有工具都返回结构化错误响应：常见错误类型：
身份验证错误：API密钥无效或丢失
速率限制错误：请求太多
验证错误：无效参数
未发现错误：资源不存在

服务器错误

：API暂时不可用

# Install dependencies
npm install

# Development mode with auto-reload (uses ts-node)
npm run dev

# Build TypeScript to JavaScript
npm run build

# Run the built server
npm start

dist/ 发展rm -rf dist 开发设置

包含编译后的JavaScript输出，由构建步骤生成。它被故意忽略了——在提交或打包之前删除它(

# Build .dxt (lightweight - no node_modules, for dev/testing)
npm run package:dxt

# Build .mcpb (full bundle - includes node_modules, for distribution)
npm run package

或重建）以保持存储库的干净。构建桌面扩展

.dxt文件大小
.mcpb:

：~19KB（仅代码和清单）

# Test with MCP Inspector
npm install -g @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector node dist/server.js

：~4.2MB（包括所有依赖项）

capture-mcp-server/
├── src/
│   ├── server.ts              # MCP server entry point
│   ├── tools/
│   │   ├── index.ts           # Tool registry (conditional loading)
│   │   ├── sam-tools.ts       # SAM.gov integration (4 tools)
│   │   ├── usaspending-tools.ts # USASpending integration (4 tools)
│   │   ├── tango-tools.ts     # Tango API integration (5 tools)
│   │   └── join-tools.ts      # Cross-API tools (2 tools)
│   └── utils/
│       └── api-client.ts      # HTTP client with rate limiting
├── dist/                      # Compiled JavaScript (generated, gitignored)
├── manifest.json              # Desktop Extension metadata
├── icon.png                   # Extension icon
├── package.json
└── tsconfig.json

测试工具

项目结构 建筑src/server.ts服务器核心

( @modelcontextprotocol/sdk ):
用途
用于MCP协议

用于桌面集成的Stdio传输 集中工具注册和布线src/tools/index.ts工具注册表

(
):
基于可用的API键动态加载工具集

当密钥丢失时启用优雅降级 根据配置提供4-15个工具src/utils/api-client.tsAPI客户端

(
):
具有速率限制的集中式HTTP客户端
输入净化和验证

跨所有API的一致错误处理

支持带超时的GET和POST

贡献
欢迎投稿！请按照以下步骤操作： git checkout -b feature/my-feature
分叉存储库
创建要素分支：
进行更改
使用MCP检查员进行彻底测试

必要时更新文档提交拉取请求

开发指南
:
遵循现有的代码风格（TypeScript、ES模块）
为新功能添加JSDoc注释
提交前，与检验员一起测试所有工具

更新README以获取新功能

尽量减少依赖关系

许可证

看

文件以获取完整的许可证文本。

支持获取帮助
问题: https://github.com/blencorp/capture-mcp-server/issues
讨论: https://github.com/blencorp/capture-mcp-server/discussions

电子邮件

：联系方式https://www.blencorp.com有用的资源
MCP文件: https://modelcontextprotocol.io/
克劳德桌面版: https://claude.ai/download
SAM.gov API: https://open.gsa.gov/api/entity-api/
USASpending.gov API: https://api.usaspending.gov/

______________________________________________________________________

探戈API : https://tango.makegov.com/docs/内置于❤️ 通过

BLEN公司

*关于博伦* BLEN，Inc是一家数字服务公司，提供新兴技术（ML/AI，RPA）、数字现代化（传统到云）和以人为中心的网络/移动设计与开发。

Capture MCP Server

快速接入

详细介绍

捕获MCP服务器

概述

目录

特性

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

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

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

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

工具可用性矩阵

快速开始

先决条件

选择您的安装方法

安装方法

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

什么是桌面扩展？

安装步骤

.mcpb安装的重要注意事项

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

步骤1：克隆和构建

步骤2：找到MCP配置文件

步骤3：添加服务器配置

步骤4：重新启动MCP客户端

步骤5：验证安装

方法3：托管版本（AWS无服务器）

建筑

先决条件

AWS凭据设置

步骤1：部署到AWS

步骤2：同步配置

步骤3：为用户创建API密钥

步骤4：构建托管扩展包

步骤5：分发给用户

成本估算

测试您的部署

自定义域（可选）

，Route53必须有一个托管区域

更新部署

CDK堆栈包括用于验证资源配置的全面测试：

备注

自定义指标

仅限HTTPS

验证凭据|

|Lambda超时|检查CloudWatch日志；一些外部API可能很慢|

需要API密钥才能访问其数据

您可以使用4个USASpending.gov工具立即开始使用服务器，然后添加API密钥以解锁其他功能。

4个SAM.gov工具（实体、机会、细节、排除）

:

5个Tango工具（合同、赠款、供应商简介、机会、支出摘要）

编辑MCP配置文件并更新

标准配置：存储在本地配置文件中（仅供您访问）

桌面扩展：存储在OS钥匙链中（macOS/Windows凭据管理器）

快速测试查询

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

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

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

测试探戈工具（需要Tango_API_KEY）

了解工具参数和响应

在没有Claude Desktop的情况下演示功能

：检查应用程序日志

添加到您的env配置中：

确保

使用Inspector直接测试API调用

:

费率限制通常每小时或每天重置一次

查询示例

安装后，您可以问自然语言问题。LLM将自动选择和使用适当的工具。

通用商业智能

机构特定查询

承包商研究

多工具查询

LLM可以自动将多个工具链接在一起：

工具参考

搜索_支出_支出_收件人_收件人

check_sam_排除项

获取机会_支出_文本

get_tango_spending_summary

探戈