OpenGov MCP Server

Accede a las APIs de datos abiertos de Socrata desde portales de datos gubernamentales.

Documentación

OpenGov MCP Server

Un servidor MCP (Model Context Protocol) que permite a clientes MCP como Claude Desktop acceder a las APIs de Socrata Open Data. Esta integración permite a Claude Desktop buscar, recuperar y analizar conjuntos de datos públicos de portales de datos gubernamentales.

Resumen

Este servidor MCP proporciona acceso a datos abiertos de cualquier portal de datos impulsado por Socrata, incluyendo los de ciudades, estados y agencias federales como:

No se requiere clave de API para el uso básico, ya que el servidor accede a datos públicos.

Características

Con este servidor MCP, los clientes pueden:

Buscar y descubrir conjuntos de datos por palabra clave, categoría o etiquetas
Ver metadatos del conjunto de datos e información de columnas
Ejecutar consultas similares a SQL para recuperar y analizar datos
Obtener estadísticas de uso del portal

Instalación para Claude Desktop

Configuración rápida con npx (Recomendado)

La forma más fácil de usar este servidor MCP es con npx, que no requiere ninguna instalación:

Crea o edita tu configuración de Claude Desktop:

Crea o edita claude_desktop_config.json en tu directorio de inicio:

{
  "mcpServers": { 
    "opengov": {
      "command": "npx",
      "args": ["-y", "opengov-mcp-server@latest"],
      "env": {
        "DATA_PORTAL_URL": "https://data.cityofchicago.org"
      }
    }
  }
}

Puedes reemplazar DATA_PORTAL_URL con cualquier portal de datos impulsado por Socrata.

Reinicia Claude Desktop (si ya estaba en ejecución)
Comienza a usar el servidor MCP:

En Claude Desktop, ahora puedes hacer preguntas como:
```
How many cars were towed in Chicago this month?
```
y puedes continuar con preguntas que profundicen en los detalles:
```
Which make and color were towed the most?
Also, were there any interesting vanity plates?
```
La primera vez que ejecutes una consulta, npx descargará y ejecutará automáticamente la última versión del servidor.

Instalación manual desde el código fuente

Si prefieres ejecutarlo desde el código fuente (para desarrollo o personalización):

Clona este repositorio:

git clone https://github.com/srobbin/opengov-mcp-server.git
cd opengov-mcp-server

Instala las dependencias y compila:
```
npm install
npm run build
```

Crea la configuración de Claude Desktop:

Crea o edita claude_desktop_config.json en tu directorio de inicio:

{
  "mcpServers": { 
    "opengov": {
      "command": "node",
      "args": [
        "/path/to/your/opengov-mcp-server/dist/index.js"
      ],
      "env": {
        "DATA_PORTAL_URL": "https://data.cityofchicago.org"
      }
    }
  }
}

Reemplaza /path/to/your/opengov-mcp-server con la ruta real donde clonaste el repositorio.

Reinicia Claude Desktop (si ya estaba en ejecución)

Herramienta disponible: get_data

Este servidor MCP proporciona una herramienta unificada get_data que Claude Desktop usa para acceder a los datos de Socrata.

Parámetros

type (cadena, obligatorio): Tipo de operación
- catalog: Buscar y listar conjuntos de datos
- categories: Listar categorías de conjuntos de datos
- tags: Listar etiquetas de conjuntos de datos
- dataset-metadata: Obtener detalles del conjunto de datos
- column-info: Obtener información de columnas del conjunto de datos
- data-access: Consultar y recuperar registros
- site-metrics: Obtener estadísticas del portal
domain (cadena, opcional): Nombre de host del portal de datos (sin protocolo)
query (cadena, opcional): Consulta de búsqueda para conjuntos de datos
datasetId (cadena): Identificador del conjunto de datos para operaciones específicas
soqlQuery (cadena, opcional): Consulta SoQL para filtrar datos
limit (número, opcional): Máximo de resultados a devolver (predeterminado: 10)
offset (número, opcional): Resultados a omitir para paginación (predeterminado: 0)

Consultas de ejemplo

Estos son ejemplos de cómo Claude Desktop formateará las consultas al servidor MCP:

// Find datasets about budgets
{
  "type": "catalog",
  "query": "budget",
  "limit": 5
}

// Get information about a dataset
{
  "type": "dataset-metadata",
  "datasetId": "6zsd-86xi"
}

// Query dataset records with SQL-like syntax
{
  "type": "data-access",
  "datasetId": "6zsd-86xi",
  "soqlQuery": "SELECT * WHERE amount > 1000 ORDER BY date DESC",
  "limit": 10
}

Opciones de configuración

El servidor requiere una variable de entorno:

DATA_PORTAL_URL: La URL del portal de datos de Socrata (por ejemplo, https://data.cityofchicago.org)

Esto se puede configurar:

En la configuración de Claude Desktop (recomendado)
En tus variables de entorno
Mediante la línea de comandos: DATA_PORTAL_URL=https://data.cityofchicago.org opengov-mcp-server