us-eli-mcp

us-eli-mcp

用于美国法律、附带可验证引文的 MCP 服务。五个来源，提供十个只读工具：

• Congress.gov API - 联邦立法的流程：法案在委员会审议和全院投票中推进的过程。
• GovInfo API - 以已发布资料包的形式提供已颁布的法律文本：美国法典、《美国法令大全》、CFR 年度版、《联邦公报》各期。
• Federal Register API - 对 1,003,504 份 FR 文档进行全文搜索（1994-2026，2026-07-07 实时验证），包括 8,513 份总统文件（1,550 项行政命令）。无需密钥。
• CourtListener search API - 对 8,294,123 份法院判决意见进行全文搜索（2026-07-07 实时验证）。其主要价值在于州级判例（加利福尼亚州、纽约州、德克萨斯州等），联邦来源均不涵盖这些内容。无需密钥，匿名访问约 5 次请求/分钟。
• eCFR API - 当前有效的《联邦法规汇编》：对 412,846 个条款进行全文搜索，并提供每个条款的修订历史。无需密钥。

本项目不包含的内容

• 州立法（全部 50 个州）——请参阅 LegiScan，这是一个免费套餐聚合器（每月 30,000 次查询），本项目未对其进行封装。
• 联邦判例法的主力工具——进行大量联邦判例法研究时，建议使用成熟的 MIT 许可证封装 （blakeox/courtlistener-mcp、 john-walkoe/courtlistener_citations_mcp）；此处的判例法工具主要用于州法院。请参阅 SOURCES.md。

工具

工具	用途
us_search_bills	按国会届次（例如 118）和类型（hr、s、hres 等）列出法案
us_get_bill	获取某项法案的完整详情和最新行动
us_list_code_packages	列出某个集合（USCODE、CFR、FR、STATUTE）中的 GovInfo 资料包
us_get_code_package	获取某个资料包的元数据和下载链接（PDF/XML/TXT）
us_search_federal_register	对 FR 文档进行全文搜索；可筛选法规、公告和行政命令
us_get_federal_register_doc	获取一份 FR 文档及其官方引文（例如 91 FR 41591）
us_search_case_law	对 800 多万份判决意见进行全文搜索；可使用 court 筛选器（例如 cal、ny、scotus）
us_get_case	按 cluster_id 获取一组判决意见
us_search_cfr_sections	对当前有效的 CFR（eCFR）进行全文搜索
us_get_cfr_section_history	获取某个 CFR 条款的修订历史（例如 15 CFR 744.3）
us_coverage	声明此连接器涵盖的内容、各类别数据的采集时间，以及——明确说明——未涵盖的内容。每个缺口均附有替代方案。

每个响应都包含 lex_uri（可解析的 API URL）、human_readable_citation （官方引文格式：“H.R. 1, 118th Congress”、“91 FR 41591”、 “People v. Miranda-Guerrero, 519 P.3d 1004 (California Supreme Court 2022)”、 “15 CFR § 744.3”）和 source_url（公开页面）。判例汇编引文均逐字取自来源，绝不捏造；若不存在判例汇编引文，则使用案卷编号。

安装

作为 Claude 插件（Claude Code 或桌面应用，需要 uv）使用； 有关该插件会发送和存储的内容，请参阅 plugin/README.md：

/plugin marketplace add matematicsolutions/us-eli-mcp
/plugin install us-eli-mcp@us-eli-mcp

作为独立服务使用：

pip install us-eli-mcp

带有 Smart App Control 的 Windows 11

Smart App Control 会阻止未签名的可执行文件，包括 uvx.exe、pip.exe 以及 pip 在安装时写入的 us-eli-mcp.exe 启动器。来自 python.org 安装程序的 python.exe 和 py.exe 由 Python Software Foundation 签名，因此通过解释器运行模块即可正常工作：

python -m pip install us-eli-mcp
python -m us_eli_mcp

出于相同原因，pip.exe 也会被阻止，因此请使用 python -m pip 安装，而不是 pip install。如果 python 不在 PATH 中，请使用 Windows 启动器：py -3 -m us_eli_mcp。

{ "mcpServers": { "us-eli-mcp": { "command": "python", "args": ["-m", "us_eli_mcp"] } } }

请勿通过关闭 Smart App Control 来绕过此限制——若不重新安装 Windows，就无法重新启用它。

配置

环境变量	默认值
US_ELI_API_KEY	DEMO_KEY（共享密钥，速率限制较低——在 api.congress.gov/sign-up 获取你自己的免费密钥）
US_ELI_GOVINFO_API_KEY	复用 US_ELI_API_KEY（属于同一 api.data.gov 密钥系列）
US_ELI_CACHE_DIR	~/.matematic/cache/us-eli
US_ELI_AUDIT_DIR	~/.matematic/audit
US_ELI_BASE_URL	https://api.congress.gov/v3
US_ELI_GOVINFO_BASE_URL	https://api.govinfo.gov
US_ELI_FR_BASE_URL	https://www.federalregister.gov/api/v1（无需密钥）
US_ELI_COURTLISTENER_BASE_URL	https://www.courtlistener.com/api/rest/v4（无需密钥）
US_ELI_ECFR_BASE_URL	https://www.ecfr.gov/api（无需密钥）

Federal Register、CourtListener 和 eCFR 工具均无需密钥。

网络：此服务会与上述五个数据源以及本地文件系统通信。首次使用时，它还会从此仓库的 GitHub Releases 下载一个小型配置文件（us-runtime.json.gz，包含更新后的数据源地址）。该请求不携带任何查询内容；我们唯一能看到的使用情况信号，是 GitHub 对该文件的下载计数。设置 US_ELI_RUNTIME_URL="" 可关闭此功能；Claude 插件默认关闭此功能。无大模型提供商，也无其他遥测数据。

许可证

Apache-2.0（代码）。Congress.gov、GovInfo、Federal Register 和 eCFR 数据属于美国政府作品（公有领域）。CourtListener 数据由 Free Law Project 提供。