Servidor MCP de Socrata

Un servidor MCP que proporciona a Claude herramientas para explorar y consultar cualquier portal de datos abiertos de Socrata.

Herramientas

Related MCP server: mcp-data-kcmo

Instalación

Requisitos previos

Necesitas Python 3.10 o superior. Comprueba tu versión:

python3 --version

Si necesitas instalar o actualizar Python:

• macOS: brew install python (requiere Homebrew)

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

• Fedora/RHEL: sudo dnf install python3

• Windows 11 nativo: Descárgalo desde python.org y marca Add to PATH durante la instalación

1. Clonar o copiar esta carpeta

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

O simplemente copia los archivos server.py y requirements.txt en una carpeta de tu elección.

2. Crear un entorno virtual

python3 -m venv .venv

3. Activar el entorno virtual

Tu prompt cambiará para mostrar (.venv) cuando esté activo.

4. Instalar dependencias

pip install -r requirements.txt

5. Verificar la instalación

python3 server.py --help

Deberías ver un error como:

RuntimeError: SOCRATA_DOMAIN environment variable is required

Eso significa que el servidor se cargó correctamente; solo necesita que se configuren tus credenciales (ver más abajo).

Configuración

Ambas variables de entorno son obligatorias. El servidor no se iniciará sin ellas.

Para obtener un token de API: inicia sesión en tu portal de Socrata → Developer Settings → Create New App Token.

Añadir a Claude Desktop

Claude Desktop lee su lista de servidores MCP desde un archivo de configuración JSON. Edita el archivo correspondiente a tu plataforma:

macOS / Linux (nativo)

{
  "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"
      }
    }
  }
}

Reemplaza /absolute/path/to/socrata-mcp con la ruta real. Encuéntrala ejecutando pwd dentro de la carpeta del proyecto.

Windows 11 (Python nativo)

{
  "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 con WSL

Claude Desktop se ejecuta en Windows pero puede iniciar un proceso WSL a través de wsl.exe:

{
  "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"
      }
    }
  }
}

Reemplaza your-wsl-username con tu nombre de usuario de WSL (ejecuta whoami dentro de WSL para comprobarlo).

Después de editar la configuración, reinicia Claude Desktop y deberías ver las herramientas de Socrata disponibles.

Licencia

Este proyecto está bajo la Licencia MIT.

Este código fue generado usando Claude de Anthropic.

Consultas de ejemplo

• "¿Qué conjuntos de datos están disponibles en el portal de datos abiertos de Delaware?"

• "Muéstrame los principales proveedores por gasto en contratos en el año fiscal 2025"

• "¿Qué columnas hay en el conjunto de datos sifm-293u?"

• "¿Qué agencias gastaron más en soluciones en la nube el año pasado?"

• "Buscar conjuntos de datos de educación en data.delaware.gov"