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.
This server cannot be installed
Ein lokaler MCP-Server, der es Benutzern ermöglicht, die CFPB-Datenbank für Verbraucherbeschwerden in natürlicher Sprache abzufragen und Datensätze zu finanziellen Verbraucherbeschwerden über die CFPB-API abzurufen.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -78715TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -7184TypeScriptMIT License
- -securityFlicense-qualityAn MCP server that connects to Backlog API, providing functionality to search, retrieve, and update issues through natural language commands.Last updated -531JavaScript
- -security-license-qualityAn MCP server that enables natural language interaction with Apache Iceberg data lakehouses, allowing users to query table metadata, schemas, and properties through Claude, Cursor, or other MCP clients.Last updated -31PythonApache 2.0