Consumer Complaint Database MCP

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.

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 :

Oder mit einfachem pip :

Läuft

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

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:

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.

Verweise

• CFPB-API-Dokumentation zur Verbraucherbeschwerdedatenbank – zugrunde liegende API, die von diesem MCP-Server verwendet wird.
• Schnellstart-Tutorial zum Model Context Protocol – Tutorial, das beim Erstellen dieses Beispiels geholfen hat.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.