Congressgov MCP Server

@cyanheads/congressgov-mcp-server

Access U.S. congressional data - bills, votes, members, committees - through MCP. STDIO & Streamable HTTP.

10 Tools • 5 Resources • 2 Prompts

公共托管服务器： https://congressgov.caseyjhand.com/mcp

______________________________________________________________________

工具

查询美国立法数据的十个只读工具：

congressgov_bill_lookup

从Congress.gov浏览和检索美国立法法案数据。

• 按会议编号、票据类型和日期范围筛选
• 检索详细的子资源：行动、修正案、委员会、共同提案人、相关法案、主题、摘要、文本版本和标题
• 分页支持浏览大型结果集

______________________________________________________________________

congressgov_member_lookup

了解国会议员及其立法活动。

• 按州、地区、国会编号和议院浏览
• 检索成员的赞助和共同赞助立法
• 通过bioguide ID查找特定成员

______________________________________________________________________

congressgov_committee_lookup

浏览国会委员会及其立法、报告和提名。

• 按会议室筛选（众议院、参议院、联合）
• 检索委员会法案、报告和提名
• 按委员会代码查找特定委员会
• 委员会法案默认为 order='recent' （最新优先）；通过 order='oldest' 按更新日期升序排列

______________________________________________________________________

congressgov_roll_votes

检索众议院唱名表决数据和个人成员投票立场。

• 按国会和会议浏览唱名表决
• 每次点名时检索个人成员的投票位置

______________________________________________________________________

congressgov_bill_summaries

浏览最近的CRS账单摘要。

• 按国会和法案类型筛选
• 按时间顺序浏览，了解国会正在发生什么

______________________________________________________________________

congressgov_crs_reports

浏览和检索CRS报告——由国会图书馆主题专家撰写的无党派政策分析。

• 浏览完整的报告目录
• 按产品编号检索单个报告

______________________________________________________________________

congressgov_daily_record

浏览每日国会记录——国会会议期间每天发布的演讲、辩论和立法文本。

• 按会议编号浏览卷
• 检索特定问题文章

资源

提示

特性

建立在 @cyanheads/mcp-ts-core:

• 声明性工具定义——每个工具一个文件，框架处理注册和验证
• 跨所有工具的统一错误处理
• 可插拔身份验证(none, jwt, oauth)
• 可交换存储后端： in-memory, filesystem, Supabase
• 带可选OpenTetry跟踪的结构化日志记录
• 在本地（stdio/HTTP）或Docker中从同一代码库运行

Congress.gov特定：

• 国会.gov REST API v3的类型安全客户端
• 通过来自的免费API密钥进行身份验证 api.data.gov
• 自动分页和响应规范化
• 限速意识（每键5000个请求/小时）
• 所有工具都是只读和幂等的

入门

公共托管实例

公共实例可在以下网址获得 https://congressgov.caseyjhand.com/mcp --无需安装。通过Streamable HTTP将任何MCP客户端指向它：

{
  "mcpServers": {
    "congressgov-mcp-server": {
      "type": "streamable-http",
      "url": "https://congressgov.caseyjhand.com/mcp"
    }
  }
}

自托管/本地

将以下内容添加到MCP客户端配置文件中。

{
  "mcpServers": {
    "congressgov-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/congressgov-mcp-server@latest"],
      "env": {
        "CONGRESS_API_KEY": "your-api-key"
      }
    }
  }
}

或者使用npx（不需要Bun）：

{
  "mcpServers": {
    "congressgov-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/congressgov-mcp-server@latest"],
      "env": {
        "CONGRESS_API_KEY": "your-api-key"
      }
    }
  }
}

在获取免费API密钥 api.data.gov/注册 （5000个请求/小时）。

先决条件

• Bun v1.3.2 或更高。

安装

1. 克隆存储库：

git clone https://github.com/cyanheads/congressgov-mcp-server.git

1. 导航到以下目录：

cd congressgov-mcp-server

1. 安装依赖项：

bun install

配置

所有配置在启动时通过Zod模式进行验证 src/config/server-config.ts.关键环境变量：

运行服务器

本地开发

• 构建并运行生产版本：

  bun run rebuild
  bun run start:http   # or start:stdio

• 运行检查和测试：

  bun run devcheck     # Lints, formats, type-checks
  bun run test         # Runs test suite

码头工人

docker build -t congressgov-mcp-server .
docker run -e CONGRESS_API_KEY=your-api-key -p 3010:3010 congressgov-mcp-server

项目结构

发展指南

看 CLAUDE.md 了解开发指南和架构规则。简短版本：

• 处理程序抛出，框架捕获——否 try/catch 工具逻辑
• 使用 ctx.log 对于日志记录， ctx.state 用于存储
• 所有工具都是只读的 readOnlyHint: true 和 idempotentHint: true

贡献

欢迎问题和拉取请求。提交前进行检查和测试：

bun run devcheck
bun run test

许可证

此项目根据Apache 2.0许可证获得许可。请参阅 许可证 文件以获取详细信息。