Verbraucherbeschwerdedatenbank-MCP

Dieses Repository enthält einen lokalen MCP -Server zur Abfrage der Verbraucherbeschwerdedatenbank des US Consumer Financial Protection Bureau (CFPB). Der Server ist für den Start über Standard-Ein-/Ausgabe konzipiert und eignet sich daher ideal für die Integration mit Tools wie Claude Desktop.

Dateien

complaints.py – Haupt-MCP-Server, der ein einzelnes Tool, search_complaints , zum Abrufen von Beschwerdedatensätzen von der CFPB-API bereitstellt.
pyproject.toml – Minimale Projektmetadaten und Abhängigkeitsdeklarationen.
claude_desktop_config.json – Beispielkonfiguration zum Starten des Servers von Claude Desktop.

Related MCP server: Firebase Realtime Database API MCP Server

Anforderungen

Python 3.11+
uv oder pip zum Installieren von Abhängigkeiten

Erforderliche Python-Pakete sind in pyproject.toml aufgelistet und umfassen httpx , mcp[cli] und python-dateutil .

Einrichtung (optional)

uv run erstellt automatisch eine virtuelle Umgebung, sperrt Ihre Abhängigkeiten, synchronisiert sie und führt anschließend das Skript aus. Wenn Sie den Server mit uv run complaints.py starten möchten, können Sie die Installation der Voraussetzungen im Voraus überspringen.

Benutzer, die Pakete lieber vorab installieren oder einfaches pip verwenden möchten, installieren Abhängigkeiten mit uv :

uv pip install -r pyproject.toml

Oder mit einfachem pip :

pip install -r pyproject.toml

Läuft

So starten Sie den Server für einen Smoke-Test direkt von der Befehlszeile aus:

uv run complaints.py

Der Server läuft nur über stdio und wartet auf Anfragen von einem MCP-fähigen Client (z. B. Claude Desktop).

Ausführen von Tests

Führen Sie die Unit-Tests mithilfe der Python-Unittest-Erkennung aus. Führen Sie im Stammverzeichnis des Repositorys Folgendes aus:

python -m unittest discover -s tests -v

Dies erfordert die Installation der in pyproject.toml aufgeführten Abhängigkeiten.

Claude Desktop-Konfiguration

Die Datei claude_desktop_config.json enthält einen Beispieleintrag, der auf das Skript complaints.py verweist. Ersetzen Sie INSERTPATH durch den Pfad zu diesem Repository auf Ihrem Computer und importieren Sie die Konfiguration in Claude Desktop.