Socrata MCP-Server

Ein MCP-Server, der Claude Tools zur Verfügung stellt, um jedes Socrata Open-Data-Portal zu durchsuchen und abzufragen.

Tools

Related MCP server: mcp-data-kcmo

Installation

Voraussetzungen

Sie benötigen Python 3.10 oder neuer. Überprüfen Sie Ihre Version:

python3 --version

Falls Sie Python installieren oder aktualisieren müssen:

• macOS: brew install python (erfordert Homebrew)

• Ubuntu/Debian / WSL: sudo apt update && sudo apt install -y python3 python3-venv python3-pip

• Fedora/RHEL: sudo dnf install python3

• Windows 11 nativ: Laden Sie es von python.org herunter und aktivieren Sie während der Installation Add to PATH

1. Diesen Ordner klonen oder kopieren

git clone https://github.com/your-username/socrata-mcp.git
cd socrata-mcp

Oder kopieren Sie einfach die Dateien server.py und requirements.txt in einen Ordner Ihrer Wahl.

2. Eine virtuelle Umgebung erstellen

python3 -m venv .venv

3. Die virtuelle Umgebung aktivieren

Ihr Prompt ändert sich zu (.venv), wenn die Umgebung aktiv ist.

4. Abhängigkeiten installieren

pip install -r requirements.txt

5. Die Installation überprüfen

python3 server.py --help

Sie sollten eine Fehlermeldung wie diese sehen:

RuntimeError: SOCRATA_DOMAIN environment variable is required

Das bedeutet, dass der Server korrekt geladen wurde – er benötigt lediglich die Konfiguration Ihrer Anmeldedaten (siehe unten).

Konfiguration

Beide Umgebungsvariablen sind erforderlich. Der Server startet nicht ohne sie.

Um ein API-Token zu erhalten: Melden Sie sich bei Ihrem Socrata-Portal an → Developer Settings → Create New App Token.

Zu Claude Desktop hinzufügen

Claude Desktop liest seine MCP-Serverliste aus einer JSON-Konfigurationsdatei. Bearbeiten Sie die Datei für Ihre Plattform:

macOS / Linux (nativ)

{
  "mcpServers": {
    "socrata": {
      "command": "/absolute/path/to/socrata-mcp/.venv/bin/python3",
      "args": ["/absolute/path/to/socrata-mcp/server.py"],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

Ersetzen Sie /absolute/path/to/socrata-mcp durch den tatsächlichen Pfad. Sie finden ihn, indem Sie pwd im Projektordner ausführen.

Windows 11 (natives Python)

{
  "mcpServers": {
    "socrata": {
      "command": "C:\\Users\\YourName\\socrata-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\YourName\\socrata-mcp\\server.py"],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

Windows 11 mit WSL

Claude Desktop läuft unter Windows, kann aber einen WSL-Prozess über wsl.exe starten:

{
  "mcpServers": {
    "socrata": {
      "command": "wsl.exe",
      "args": [
        "--exec",
        "/home/your-wsl-username/socrata-mcp/.venv/bin/python3",
        "/home/your-wsl-username/socrata-mcp/server.py"
      ],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

Ersetzen Sie your-wsl-username durch Ihren WSL-Benutzernamen (führen Sie whoami innerhalb von WSL aus, um ihn zu überprüfen).

Starten Sie nach dem Bearbeiten der Konfiguration Claude Desktop neu. Die Socrata-Tools sollten nun verfügbar sein.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Dieser Code wurde mit Claude von Anthropic generiert.

Beispielabfragen

• "Welche Datensätze sind auf dem Open-Data-Portal von Delaware verfügbar?"

• "Zeige mir die Top-Anbieter nach Vertragsausgaben im Geschäftsjahr 2025"

• "Welche Spalten enthält der Datensatz sifm-293u?"

• "Welche Behörden haben letztes Jahr am meisten für Cloud-Lösungen ausgegeben?"

• "Suche nach Bildungsdatensätzen auf data.delaware.gov"