Congress.gov API MCP Server
2025.04.04
0
TypeScript立法数据服务API 网关其它
Congress.gov API MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在通过混合方式提供对美国国会官方 API (v3) 的访问。它支持通过标准化 URI 直接查询核心立法实体（如法案、议员、国会、委员会等），并提供复杂操作工具（如跨集合搜索和获取相关数据列表）。该服务作为桥梁，使 MCP 客户端（如 AI 助手或开发工具）能够轻松查询和利用美国立法数据。
View on GitHub
Overview
基本能力
产品定位
Congress.gov API MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在通过混合方式提供对美国国会官方 API (v3) 的访问。它支持通过标准化 URI 直接查询核心立法实体（如法案、议员、国会、委员会等），并提供复杂操作工具（如跨集合搜索和获取相关数据列表）。该服务作为桥梁，使 MCP 客户端（如 AI 助手或开发工具）能够轻松查询和利用美国立法数据。
核心功能
- MCP Resources：支持通过标准化 URI 直接查询核心立法实体，包括法案、议员、国会、委员会和一般信息。
- MCP Tools：提供复杂操作工具，如跨集合搜索 (
congress_search) 和获取相关数据列表 (congress_getSubResource)。 - 两步骤工作流：许多常见任务需要通过
congress_search找到实体 ID，然后使用congress_getSubResource获取相关数据。
适用场景
- 立法研究：查询法案、议员信息及其相关数据。
- 政策分析：通过搜索和分析法案内容，支持政策研究和决策。
- 开发工具集成：为开发工具或 AI 助手提供立法数据访问接口。
工具列表
- congress_search：用于跨集合搜索核心立法实体（如法案、议员等）。
- congress_getSubResource：用于获取与特定实体相关的数据列表（如法案的行动、议员的赞助法案等）。
常见问题解答
- API 限制：搜索功能不支持按国会直接过滤，需通过特定 API 路径实现。
- 两步骤工作流：必须首先通过
congress_search找到实体 ID，然后才能使用congress_getSubResource获取相关数据。 - 错误处理：提供无效的
subResource字符串会导致错误，需确保组合有效。
使用教程
使用依赖
- 安装 Node.js 和 npm。
- 获取 Congress.gov API 密钥（从 https://api.data.gov/signup/ 注册）。
安装教程
- 安装依赖：
bash npm install - 设置 API 密钥：在项目根目录创建
.env文件并添加：CONGRESS_GOV_API_KEY=YOUR_API_KEY_HERE - 构建服务器：
bash npm run build - 运行服务器：
bash npm start
调试方式
- 开发模式：
bash npm run dev - Lint 和格式化：
bash npm run lint npm run format