opengov-mcp-server

OpenGov MCP-Server

Ein MCP-Server (Model Context Protocol), der MCP-Clients wie Claude Desktop den Zugriff auf Socrata Open Data APIs ermöglicht. Diese Integration ermöglicht es Claude Desktop, öffentliche Datensätze von staatlichen Datenportalen zu suchen, abzurufen und zu analysieren.

Überblick

Dieser MCP-Server bietet Zugriff auf offene Daten von jedem Socrata-basierten Datenportal, einschließlich der Daten von Städten, Bundesstaaten und Bundesbehörden wie:

• Chicago
• NYC
• San Francisco
• Los Angeles
• Und andere Regierungsstellen

Für die grundlegende Nutzung ist kein API-Schlüssel erforderlich, da der Server auf öffentliche Daten zugreift.

Merkmale

Mit diesem MCP-Server können Clients:

• Suchen und entdecken Sie Datensätze nach Stichwort, Kategorie oder Tags
• Anzeigen von Dataset-Metadaten und Spalteninformationen
• Führen Sie SQL-ähnliche Abfragen aus, um Daten abzurufen und zu analysieren
• Abrufen von Statistiken zur Portalnutzung

Installation für Claude Desktop

Schnelleinrichtung mit npx (empfohlen)

Am einfachsten lässt sich dieser MCP-Server mit npx verwenden, da hierfür keine Installation erforderlich ist:

1. Erstellen oder bearbeiten Sie Ihre Claude Desktop-Konfiguration :Erstellen oder bearbeiten Sie claude_desktop_config.json in Ihrem Home-Verzeichnis:
   { "mcpServers": { "opengov": { "command": "npx", "args": ["-y", "opengov-mcp-server@latest"], "env": { "DATA_PORTAL_URL": "https://data.cityofchicago.org" } } } }
   Sie können die DATA_PORTAL_URL durch jedes von Socrata betriebene Datenportal ersetzen.
2. Starten Sie Claude Desktop neu (falls es bereits ausgeführt wurde)
3. Beginnen Sie mit der Verwendung des MCP-Servers :In Claude Desktop können Sie jetzt Fragen stellen wie:
   How many cars were towed in Chicago this month?
   und Sie können anschließend Fragen stellen, die tiefer ins Detail gehen:
   Which make and color were towed the most? Also, were there any interesting vanity plates?
   Wenn Sie zum ersten Mal eine Abfrage ausführen, lädt npx automatisch die neueste Version des Servers herunter und führt sie aus.

Manuelle Installation von der Quelle

Wenn Sie die Ausführung lieber aus der Quelle heraus vornehmen möchten (zur Entwicklung oder Anpassung):

1. Klonen Sie dieses Repository :
   git clone https://github.com/srobbin/opengov-mcp-server.git cd opengov-mcp-server
2. Installieren Sie Abhängigkeiten und erstellen Sie :
   npm install npm run build
3. Erstellen Sie die Claude Desktop-Konfiguration :Erstellen oder bearbeiten Sie claude_desktop_config.json in Ihrem Home-Verzeichnis:
   { "mcpServers": { "opengov": { "command": "node", "args": [ "/path/to/your/opengov-mcp-server/dist/index.js" ], "env": { "DATA_PORTAL_URL": "https://data.cityofchicago.org" } } } }
   Ersetzen Sie /path/to/your/opengov-mcp-server durch den tatsächlichen Pfad, in den Sie das Repository geklont haben.
4. Starten Sie Claude Desktop neu (falls es bereits ausgeführt wurde)

Verfügbares Tool: get_data

Dieser MCP-Server bietet ein einheitliches get_data Tool, das Claude Desktop für den Zugriff auf Socrata-Daten verwendet.

Parameter

• type (Zeichenfolge, erforderlich): Vorgangstyp
  • catalog : Datensätze suchen und auflisten
  • categories : Datensatzkategorien auflisten
  • tags : Datensatz-Tags auflisten
  • dataset-metadata : Datensatzdetails abrufen
  • column-info : Informationen zu den Dataset-Spalten abrufen
  • data-access : Abfragen und Abrufen von Datensätzen
  • site-metrics : Portalstatistiken abrufen
• domain (Zeichenfolge, optional): Hostname des Datenportals (ohne Protokoll)
• query (Zeichenfolge, optional): Suchanfrage für Datensätze
• datasetId (Zeichenfolge): Datensatzkennung für bestimmte Vorgänge
• soqlQuery (Zeichenfolge, optional): SoQL-Abfrage zum Filtern von Daten
• limit (Zahl, optional): Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 10)
• offset (Zahl, optional): Ergebnisse, die bei der Paginierung übersprungen werden sollen (Standard: 0)

Beispielabfragen

Dies sind Beispiele dafür, wie Claude Desktop Abfragen an den MCP-Server formatiert:

Konfigurationsoptionen

Der Server benötigt eine Umgebungsvariable:

• DATA_PORTAL_URL : Die URL des Socrata-Datenportals (z. B. https://data.cityofchicago.org )

Dies kann eingestellt werden:

• In der Claude Desktop-Konfiguration (empfohlen)
• In Ihren Umgebungsvariablen
• Über die Befehlszeile: DATA_PORTAL_URL=https://data.cityofchicago.org opengov-mcp-server