用途
mcp-sam-gov 是一个 MCP(Model Context Protocol)服务器,旨在让 AI 智能体能够查询美国联邦和州/地方(SLED)的政府采购、支出、法规和合作伙伴审查数据。其核心目标是降低查询公共数据的门槛,避免高昂的订阅费用。数据本身属于公共领域。
主要能力
服务器提供 153 个工具,覆盖 54 个数据源。关键数据源包括 SAM.gov、USAspending、Grants.gov、OFAC、FDIC、EPA、CourtListener 等。工具按工作流分组,覆盖以下场景:
- 采购机会搜索:搜索 SAM.gov 上的活跃合同机会、预招标信息(Sources Sought / Presol / Special Notices),获取详细信息(联系点、附件、正文)。
- 竞争格局分析:查询特定机构或 NAICS 代码下的合同获得者、单个奖项、分包商等。
- 趋势与聚合:分析历史支出趋势、各州或产品服务代码(PSC)的支出排名、赠款项目等。
- 机构情报:生成机构概况、预算分解、交易量等。
- 再竞争雷达:查找即将到期的合同、履约期信息。
- 法规与立法:搜索 FAR 条款、生成合规矩阵、查询 Federal Register、Regulations.gov 评论、eCFR 规则文本等。
- 合作伙伴与实体审查:对照 OFAC 制裁名单、SAM 排除名单筛查实体,查询 NPI 状态、单一审计发现、银行健康度、SEC EDGAR 财务数据、EPA 合规标志等。
- 合规与资格:查询 SBA 小企业规模标准、HTS 进口关税税率等。
- 定价、劳动力与财政:查询 GSA CALC 费率、SCA 工资裁定、CPI-U 变化、美国公共债务、CISA KEV 漏洞清单等。
- 健康与研究资助:查询 NIH RePORTER 项目、临床试验、CMS Open Payments 数据等。
使用方式
安装路径有四种:
- Claude Desktop 一键安装:下载最新版本的 mcp-sam-gov.mcpb 文件,双击后 Claude Desktop 会弹出安装对话框,点击安装即可。需要 Claude Desktop 1.0 或更高版本。
- Claude Code 单命令:适用于已使用 Claude Code CLI 的用户,安装 MCP 服务器及 SKILL.md 工作流指南。
- 手动安装:适用于任何支持 MCP 的主机(Codex、Cursor、Continue、Gemini 等)。通过 npm 全局安装后,二进制文件 mcp-sam-gov 会加入 PATH。配置主机时,可选用全局安装("command": "mcp-sam-gov")或 npx 免全局安装("command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"])。注意 npm 包名为 @cliwant/mcp-sam-gov,不带作用域的 mcp-sam-gov 不存在。
- 直接路径零安装:跳过安装,直接将主机配置指向文件的绝对路径。
各主机的具体配置位置已在官方文档中列出,支持 Windows 和 macOS。安装后,用户可用自然语言提问,AI 智能体会自动选择工具序列。例如:“Find active SAM.gov solicitations under NAICS 541512, MD only, closing in 30 days”。
密钥与限制
服务器默认无密钥运行。四个数据源需要免费密钥:Census(census_business_patterns)、FRED(fred_search_series、fred_series_observations)、BEA(bea_regional_data)和 DOL 数据端点(dol_get_dataset)。其余密钥为可选,仅用于提高速率限制或解锁筛选功能。所有密钥均可免费获取。设置方式有两种:在主机环境变量块中设置,或在服务器工作目录下创建 .env 文件。服务器启动时自动加载 .env,环境变量优先级高于 .env。可使用无密钥的 api_key_status 工具查看所需密钥、是否必需、注册链接及当前是否已配置。
为减少上下文消耗,可通过 MCP_SAM_GOV_TOOLSETS 环境变量指定加载的工具集(逗号分隔,不区分大小写),留空或设为 all 则加载全部 153 个工具(约 74k tokens)。feedback 和 api_key_status 工具始终加载。若调用了未加载工具集的工具,服务器会返回结构化错误并提示需设置的环境变量。
服务器在启动时会向 npm 公共注册表发起一次匿名请求检查自身最新版本,仅当有新版本时在 stderr 输出一行提示。不会发送使用数据,不触碰协议 stdout,非阻塞。可通过 MCP_SAM_GOV_NO_UPDATE_CHECK=1 或 NO_UPDATE_NOTIFIER=1 退出。
适用场景
适用于需要查询美国政府采购、支出、法规和实体审查数据的用户,包括政府承包商、合规人员、研究人员、记者等。尤其适合希望以自然语言方式让 AI 智能体自动完成多步骤数据查询的场景。
限制
- 项目独立,与 SAM.gov、GSA 或任何政府机构无隶属或背书关系。
- 部分数据源需要免费密钥才能使用,无密钥时工具会抛出错误。
- 延迟因数据源和上游负载而异,早期 52 工具版本测得 p50 约 0.25 秒、p95 约 0.8 秒,仅供参考,非保证。
- 数据.gov 系列源使用公共 DEMO_KEY,配额较低,可通过 DATA_GOV_API_KEY 提高。
- BLS 源可选使用免费 BLS_API_KEY 提高每日配额。
- 错误报告通过智能体生成预填 GitHub issue 链接,不会自动发布,需用户手动提交。
- 反馈链接仅包含工具名、错误类型和服务器版本,不含查询值。
分类
根据其明确用途,本工具属于 AI 开发平台(ai-frameworks),具体为 MCP 服务器,用于扩展 AI 智能体的数据查询能力。