Us Eli Mcp

io.github.matematicsolutions由 GitHub 账号 matematicsolutions 发布v0.5.3更新于 Oct 24, 2026

US law MCP: bills, US Code, Federal Register, executive orders, case law (state+federal), eCFR

概览

AI 生成的概览

本地 MCP 服务器,让助手检索美国联邦与州法律资料:法案、美国法典、联邦公报、行政命令、判例法及 eCFR。

可以做什么
检索与读取联邦法案:按届会和类型列出法案,并获取单个法案的完整详情与最新进展。浏览 GovInfo 已颁布法律包(美国法典、法令大全、CFR、联邦公报),获取元数据与下载链接。全文检索联邦公报文件,可按规则、通知、行政命令筛选,并获取单份文件及其官方引注。检索联邦与州法院判决书,并按 cluster_id 获取单个判决。检索现行 CFR 条文并查看某条文的修订历史。说明该连接器覆盖与不覆盖的范围,并为每处缺口给出替代来源。
适用场景
适合需要查询美国立法、法规或判例并希望结果附带官方引注的场景,尤其是联邦来源不覆盖的州判例法。它提供只读研究支持,不适合作为繁重联邦判例研究的主力工具。
运行要求
以本地 Python 包运行(pip 安装或 uvx);通过 Claude 插件方式安装需要 uv。需要访问 Congress.gov、GovInfo、Federal Register、CourtListener 和 eCFR 的网络。可选环境变量:US_ELI_API_KEY(默认使用共享的 DEMO_KEY,速率限制较低)、US_ELI_GOVINFO_API_KEY、US_ELI_CACHE_DIR、US_ELI_AUDIT_DIR 以及基础 URL 覆盖项。Federal Register、CourtListener 和 eCFR 无需密钥。
安装前请注意
默认的 US_ELI_API_KEY 是共享演示密钥,速率限制较低,建议申请个人免费密钥。首次使用时会从项目 GitHub Releases 获取一个小型配置文件,可通过将 US_ELI_RUNTIME_URL 设为空来关闭。它会在本地目录写入缓存与审计文件。所有工具均为只读;不使用 LLM 提供商,也没有其他遥测。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Us Eli Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

us-eli-mcp

MCP server for US law with verifiable citations. Five sources behind ten read-only tools:

  • Congress.gov API - the federal legislative process: bills as they move through committees and floor votes.
  • GovInfo API - enacted law text as published packages: US Code, Statutes at Large, CFR annual editions, Federal Register issues.
  • Federal Register API - full-text search over 1,003,504 FR documents (1994-2026, live-verified 2026-07-07), including 8,513 presidential documents (1,550 executive orders). Keyless.
  • CourtListener search API - full-text search over 8,294,123 court opinions (live-verified 2026-07-07). The headline value is STATE case law (California, New York, Texas, ...), which no federal source covers. Keyless, ~5 requests/min anonymous.
  • eCFR API - the CURRENT Code of Federal Regulations: section-level full-text search over 412,846 sections plus per-section amendment history. Keyless.

What this is not

  • State legislation (all 50 states) - see LegiScan, a free-tier aggregator (30,000 queries/month) not wrapped here.
  • A federal case-law workhorse - for heavy federal case-law research the mature MIT-licensed wrappers (blakeox/courtlistener-mcp, john-walkoe/courtlistener_citations_mcp) remain the recommendation; the case-law tools here exist primarily for state courts. See SOURCES.md.

Tools

ToolPurpose
us_search_billsList bills by congress (e.g. 118) and type (hr, s, hres, ...)
us_get_billFull detail + latest action for one bill
us_list_code_packagesList GovInfo packages in a collection (USCODE, CFR, FR, STATUTE)
us_get_code_packageMetadata + download links (PDF/XML/TXT) for one package
us_search_federal_registerFull-text search over FR documents; filter rules, notices, executive orders
us_get_federal_register_docOne FR document with its official citation (e.g. 91 FR 41591)
us_search_case_lawFull-text search over 8M+ opinions; court filter (e.g. cal, ny, scotus)
us_get_caseOne opinion cluster by cluster_id
us_search_cfr_sectionsFull-text search over the current CFR (eCFR)
us_get_cfr_section_historyAmendment history of one CFR section (e.g. 15 CFR 744.3)
us_coverageDeclare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback.

Every response carries lex_uri (a resolvable API URL), human_readable_citation (the official convention: "H.R. 1, 118th Congress", "91 FR 41591", "People v. Miranda-Guerrero, 519 P.3d 1004 (California Supreme Court 2022)", "15 CFR § 744.3") and source_url (the public page). Reporter citations are taken verbatim from the source and never fabricated; when none exists the docket number is used instead.

Install

As a Claude plugin (Claude Code or the desktop app, needs uv); see plugin/README.md for what it sends and stores:

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

As a standalone server:

bash
pip install us-eli-mcp

Windows 11 with Smart App Control

Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe and the us-eli-mcp.exe launcher that pip writes at install time. The python.exe and py.exe from the python.org installer are signed by the Python Software Foundation, so running the module through the interpreter works:

bash
python -m pip install us-eli-mcppython -m us_eli_mcp

pip.exe is blocked for the same reason, so install with python -m pip, not pip install. If python is not on PATH, use the Windows launcher: py -3 -m us_eli_mcp.

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

Do not turn Smart App Control off to work around this - it cannot be re-enabled without reinstalling Windows.

Configuration

Env varDefault
US_ELI_API_KEYDEMO_KEY (shared, low rate limit - get your own free key at api.congress.gov/sign-up)
US_ELI_GOVINFO_API_KEYreuses US_ELI_API_KEY (same api.data.gov key family)
US_ELI_CACHE_DIR~/.matematic/cache/us-eli
US_ELI_AUDIT_DIR~/.matematic/audit
US_ELI_BASE_URLhttps://api.congress.gov/v3
US_ELI_GOVINFO_BASE_URLhttps://api.govinfo.gov
US_ELI_FR_BASE_URLhttps://www.federalregister.gov/api/v1 (keyless)
US_ELI_COURTLISTENER_BASE_URLhttps://www.courtlistener.com/api/rest/v4 (keyless)
US_ELI_ECFR_BASE_URLhttps://www.ecfr.gov/api (keyless)

The Federal Register, CourtListener and eCFR tools need no key at all.

Network: the server talks to the five sources above and the local filesystem. Once, on first use, it also fetches a small configuration file (us-runtime.json.gz, updated source addresses) from this repository's GitHub Releases. That request carries no query content; GitHub's download counter for the file is the only usage signal we see. US_ELI_RUNTIME_URL="" turns it off; the Claude plugin ships with it off. No LLM provider, no other telemetry.

License

Apache-2.0 (code). Congress.gov, GovInfo, Federal Register and eCFR data are US government works (public domain). CourtListener data is provided by the Free Law Project.

来源:README.md,提交 43b9e9c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.5.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分