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 分