ecfr-mcp

MCP-Server für die eCFR-API (Electronic Code of Federal Regulations). Liest FAR-, DFARS- und die FAR-Ergänzungstexte aller Behörden, ohne dass eine Authentifizierung erforderlich ist.

Die eigenständige Nutzung von MCP ist ein fortgeschrittener, selbst zu administrierender Pfad; vorgefertigte Agents sind der gepflegte Einstiegspfad.

Durch sechs Runden Integrationstests gegen die Live-eCFR-API getestet und gehärtet. 295 Regressionstests (182 offline, 113 live-gesteuert) decken 2 katastrophale P0-Fehler, 22 P1-Fehler mit still falschen Daten, 26 P2-Validierungslücken und die Audit-Korrekturen der sechsten Runde ab (Kapitel-Whitelist für Titel 48, Tabellenextraktion, Anhangsaccess). Siehe testing.md für den vollständigen Testbericht.

Funktionen

Stellt die eCFR-API als 13 MCP-Tools bereit, die Verordnungstexte, Struktur, Suche, Versionshistorie und übliche Beschaffungsworkflows abdecken:

Kern-Endpunkte

• get_latest_date – Ermittelt das neueste verfügbare Datum für einen CFR-Titel (vor anderen Tools aufrufen)

• get_cfr_content – Liefert geparsten Verordnungstext für einen Abschnitt, Unterabschnitt oder Teil

• get_cfr_structure – Hierarchisches Inhaltsverzeichnis

• get_version_history – Änderungshistorie für einen Abschnitt oder Teil

• get_ancestry – Breadcrumb-Hierarchiepfad

• search_cfr – Volltextsuche mit Hierarchiefiltern

• list_agencies – Alle Behörden with their CFR-Referenzen

• get_corrections – Redaktionelle Korrekturen für einen Titel

Workflow-Komfort

• lookup_far_clause – FAR/DFARS-Klauseltext in einem Aufruf (Datum wird automatisch aufgelöst)

• compare_versions – Nebeneinander-Gegenüberstellung des Texts zweier Daten

• list_sections_in_part – Alle Abschnitte in einem FAR/DFARS-Teil

• find_far_definition – Sucht eine Begriffsdefinition in FAR 2.101

• find_recent_changes – Abschnitte, die seit einem bestimmten Datum geändert wurden

Related MCP server: regulationsgov-mcp

Keine Authentifizierung erforderlich

die eCFR-API ist vollständig öffentlich. Kein API-Schlüssel, keine Registrierung, keinerlei Authentifizierungs-Header. Einfach installieren und verwenden.

Installation

Via uvx (empfohlen)

uvx ecfr-mcp

Via pip

pip install ecfr-mcp

Aus dem Quellcode

git clone https://github.com/1102tools-dev/federal-contracting-mcps.git
cd federal-contracting-mcps/servers/ecfr-mcp
pip install -e .

Server-Konfiguration

MCP ist ein offener Standard, und kompatible Clients können diesen Server ausführen. Der gepflegte 1102tools Agent Setup Guide behandelt vorgefertigte Agents in Codex und Claude Code, nicht die eigenständige Konfiguration des Servers. Verwenden Sie den unten stehenden Block als Serverdefinition and passen Sie dessen Platzierung an Ihren Client an.

{
  "mcpServers": {
    "ecfr": {
      "command": "uvx",
      "args": ["--refresh-package", "ecfr-mcp", "--from", "ecfr-mcp", "ecfr-mcp"]
    }
  }
}

Das Flag --refresh-package weist uv an, bei jedem Start aus der Ihres Clients nach eine neueren Version auf PyPI zu suchen, sodass Fixes automatisch angekommen werden; ohne diesen, bedient uv weiterhin die erstmals gecachte Version. Das sorgt für einen kurzen Netzwerkzugriff beim Start; erhöhen Sie gegebenenfalls das MCP-Startzeitlimit Ihrer Plattform, falls dort ein kurzes erzwungen wird.

Starten Sie den Client neu. Der ecfr-Server erscheint mit 13 Tools.

Beispiel-Prompts

• „Holen Sie den aktuellen Text von FAR 15.305 (Proposal Evaluation) und fassen Sie zusammen, was er verlangt."

• „Listen Sie alle Abschnitte in FAR Teil 19 (Small Business Programs) auf."

• „Schlagen Sie die FAR-Definition von ‚commercial product‘ in 2.101 nach."

• „Welche FAR-Abschnitte wurden in den letzten 6 Monaten geändert?"

• „Vergleichen Sie FAR 52 -212-4 zwischen 2024-01-01 und 2025-01-01 und zeigen Sie mir, was sich geändert hat."

• „Holen Sie den aktuellen Text von DFARS 252.227-7014 (Rights in Noncommercial Computer Software)."

• „Durchlangen Sie Titel 48 nach ‚organizational conflict of interest‘ und zeigen Sie mir die relevanten Abschnitte."

• „Welche Behörde ist für Kapitel 8 in Titel 48 zuständig? Holt deren FAR-Ergänzungsstruktur."

Gestaltungshinweise

• XML serverseitig geparst. Der eCFR-Inhaltsendpunkt liefert rohes XML. Dieser Server parst es in bereinigter Textform (Überschriften, Absätze, Zitierungen), bevor es an das Modell übergibt, und spart so erheblich an Kontext-Token.

• Automatische Datumsauflösung. Die eCFR hinkt 1 bis 2 Werktage hinter dem Federal Register. Wenn man auf Versionsendpunkten das heutige Datum verwendet, führt das zu 404-Fehlern. Auf deren Inhaltswerkzeuge lösen automatisch auf das neueste verfügbare Datum auf, es sei denn, ein Datum wird angegeben.

• Suche standardmäßig mit aktuellem Text. Ohne date=current liefert die eCFR-Suche ALLE historischen Versionen einschließlich abgelösster Fassungen. Das Standardverhalten current_only=True verhindert doppelte Treffer.

• Einschränkung des Strukturendpunkts. Der eCFR-Strukturendpunkt unterstützt keine Filterung auf Abschnittsebene (gibt stattdessen einen 400-Fehler zurück). list_sections_in_part umgeht das, indem es die Teilstruktur abruft und den Baum durchläuft.

• FAR-2.101-Optimierung. Der Definitionsabschnittriends ~109 KB XML. find_far_definition parst den vollständigen Abschnitt serverseitig und liefert nur passende Absätze mit Kontext zurück.

Kurzübersicht: Titel 48 des CFR

Datenquelle

Alle Daten stammen von Webseite – die fortlaufend aktualisierte Online-Ausgabe des Code of Federal Regulations, herausgegeben vom Office of the Federal Register und täglich aktualisiert, meist 1–2 Werktage nach der Veröffentlichung im Federal Register. Es handelt sich nicht wort eine amtliche Rechtsausgabe; für offizielle Homepage zu Zitaten verwenden Sie die jährliche beim GPO herausgegebene CFR.

Teil von

federal-contracting-mcps: Monorepository mit MCP-Servern für Bundesbeschaffungsdaten. Ergänzend zu federal-contracting-skills.

Steuerung der Anforderungsfrequenz

Alle ausgehendenanforderungen verwenden standardmäßig ein vorläufiges 3-Sekunden-prozessübergreifendes Anti-Burst-Intervall. Da eCFR keinen numerischen Grenzwert veröffentlicht, handelt es sich um Sicherheitsmaßnahme von 1102tools und nicht um eine Vorgabe des Anbieters. Zum Vorgabe überschreiben die Variable FEDERAL_API_T_MIN_INTERVAL_SECONDS, mit 0 wird diese Verhalten deaktiviert, und mit FEDERAL_API_PACING_DIR den lokalen Taktzustand verlegen.

Lizenz

MIT