快速结论
Congress.gov MCP Server 是 cyanheads 维护的开源社区封装,通过 Model Context Protocol 查询 Congress.gov API v3 及相关官方国会数据。截至 2026-07-21,当前版本为 v0.4.1,包含 11 个只读幂等工具、5 个资源和 2 个研究提示。它不是美国国会、美国国会图书馆或 Congress.gov 官方发布、审查或背书的 MCP 产品;官方身份只属于上游数据和原始网站。
它适合记者、政策研究者、公共事务和公民科技团队做结构化发现与初步分析,但不能替代正式法案文本、国会记录、法律意见或机构存档。Agent 生成的摘要可能遗漏修正案、版本、程序阶段和时间语境。涉及法律、游说披露、投资或公共政策决策时,必须回到原始文件并由具备领域能力的人复核。
核心功能
- 法案与法律:浏览法案行动、发起人、摘要、文本版本、相关法案和已颁布的公私法。
- 议员、委员会与投票:按州、选区和国会查询议员档案,读取委员会关联资料及众参两院唱名投票和议员立场。
- 提名与研究材料:查询总统提名、参议院确认、CRS 法案摘要、CRS 政策报告、委员会报告和每日国会记录。
- 本地全文搜索:v0.4.0 起增加
congressgov_search_bills,对法案标题和 CRS 摘要建立本地 BM25 镜像;该功能默认关闭,需自建索引并显式启用。 - Agent 上下文:5 个资源提供当前国会、法案类型、议员、法案和委员会信息,2 个提示用于法案分析和跨国会研究框架。
适合人群
- 需要以固定字段和可重复过滤条件追踪美国联邦立法的研究人员、记者和公共事务团队。
- 希望把法案、投票、议员与 CRS 资料接入 MCP 客户端的公民科技开发者。
- 能管理 API 限额、缓存、日志、依赖更新和引用核验的工程团队。
- 不适合要求法律结论、实时官方通知、零误差自动发布或个人政治画像的场景。
使用场景
可用它追踪某届国会中特定类型法案的最新行动,比较议员在唱名投票中的公开立场,整理委员会报告和 CRS 资料,或为新闻线索生成待核验的来源清单。全文镜像适合弥补官方 API 缺少通用关键词发现的问题,但镜像只覆盖法案标题与 CRS 摘要,且新鲜度取决于本地同步,不应被描述成 Congress.gov 全站搜索。
研究输出应保留国会届次、法案类型和编号、文本版本、查询时间、工具参数和官方 URL。法案标题相似不代表内容相同,提出、通过一院、两院通过、签署成法是不同状态;CRS 摘要和报告有助理解,但不等于立法机关的法律解释。模型不得在缺少证据时推断议员动机、党派意图或个人属性。
价格与版本
代码采用 Apache-2.0 许可证,包和公共社区端点不收软件费。未配置 API Key 时可使用 DEMO_KEY,官方文档标示限额为每小时 30 次;免费申请自己的 api.data.gov Key 后限额可提高至每小时 5000 次,但实际规则应以上游为准。自托管需要承担运行、镜像存储、索引更新、监控和安全维护成本。
v0.4.1 是 v0.4.0 全文镜像功能的容器构建修复,没有新增运行时能力。生产使用应固定包或镜像版本、验证校验来源,并对上游字段变化做回归测试。公共端点适合非敏感试用,不提供机构级 SLA。
国内访问与使用体验
项目依赖 GitHub、npm、社区托管域名、api.data.gov 和美国政府网站,中国大陆网络下的可达性与延迟不稳定,因此标记 needsVPN: true 只表示访问条件,不提供任何网络服务建议。使用前应测试 DNS、TLS、超时、限流和官方站点回链,并设计缓存和失败提示,不能把一次成功调用当作长期可用保证。
上游国会记录通常是公开政府数据,但查询仍可能暴露组织的政策关注、尚未公开的调查方向或客户委托。公共 MCP 端点、模型提供商、网关和日志系统都可能看到查询;不要发送机密分析、个人身份资料、访问令牌或不必要的内部上下文。自建全文镜像还需记录来源、更新时间和删除策略,防止旧摘要被误当最新官方状态。API Key 应放在服务端密钥管理中,不要写进提示或共享工作流。
优点
- 11 个只读工具覆盖法案、法律、议员、委员会、投票、提名、CRS 和每日记录。
- 本地全文镜像提供官方 API 原本缺少的关键词发现入口,同时保持显式启用。
- 资源与研究提示便于 Agent 先读取国会背景,再执行结构化查询。
- 可用
DEMO_KEY快速验证,正式免费 Key 的限额适合常规研究原型。 - Apache-2.0 代码可审计,并支持 stdio、HTTP 和容器部署。
不足
- 非官方社区封装,政府机构不保证其代码、安全响应、托管可用性或结论。
- 覆盖美国联邦国会数据,不包含州立法、法院判例、行政法规或完整法律研究体系。
- 全文镜像需要本地初始化和持续同步,默认关闭且搜索范围有限。
- 公共托管会增加查询日志、第三方处理和供应链风险。
- 立法版本与程序状态复杂,模型摘要容易抹平时间和法律差异。
- 无 API Key 的演示限额很低,自建服务仍需运维能力。
替代品对比
| 工具 | 更适合 | 关键区别 |
|---|---|---|
| Perplexity | 广泛网页与新闻研究 | 来源范围更广,但缺少 Congress.gov 专用结构和可重复字段查询 |
| Tavily | 给 Agent 提供通用网页搜索 API | 易接入开放网络,仍需自行识别和验证官方国会来源 |
| ChatGPT | 通用政策解释和交互式写作 | 成品体验更完整,但不是透明、固定的国会数据连接器 |
| Claude | 阅读长法案和比较文档 | 长文分析强,原始材料获取与版本治理需另行解决 |
| Dify | 构建带权限与审核的研究应用 | 提供应用编排,需要自行连接官方 API、缓存和引用体系 |
| n8n | 定时同步、通知和人工审批流程 | 自动化能力更强,但国会数据模型和工具要自行实现 |
常见问题 FAQ
这是 Congress.gov 官方 MCP 服务器吗?
不是。它是 cyanheads 的非官方社区项目,读取官方数据,但代码、包和公共端点不代表美国国会或国会图书馆。
v0.4.1 有多少个工具?
共有 11 个只读工具。新增的法案全文搜索依赖本地标题与 CRS 摘要镜像,默认不可调用,需显式启用并建索引。
必须申请 CONGRESS_API_KEY 吗?
不是。缺省可使用低限额 DEMO_KEY;稳定研究应申请免费 Key,并按当前官方限额和使用条款管理。
MCP 摘要能当作法律意见吗?
不能。应核验具体法案编号、文本版本、行动日期和官方文件,并在高风险事项中咨询合格专业人员。
公开政府数据是否没有隐私风险?
不是。数据公开不代表查询意图、客户委托、内部备注或组合分析公开,第三方日志仍可能泄露敏感研究方向。
本地全文搜索会自动保持最新吗?
不会。索引需要初始化和同步,团队必须记录更新时间,并在发布结论前回查官方记录。
总结
Congress.gov MCP Server 为美国国会公开数据提供了覆盖面较完整的结构化 MCP 接口,v0.4.1 的可选全文镜像改善了法案发现。它最适合作为研究入口和来源定位工具,而不是官方记录、法律数据库或自动判断系统。先用低风险查询验证字段和限额,生产环境固定版本并保护 API Key;任何结论都应保留官方链接、文本版本与查询日期,并由人员复核时效、法律语境和引用。