Servidor MCP de OpenGov

Un servidor MCP (Protocolo de Contexto de Modelo) que permite a clientes MCP como Claude Desktop acceder a las API de Datos Abiertos de Socrata. Esta integración permite a Claude Desktop buscar, recuperar y analizar conjuntos de datos públicos de portales de datos gubernamentales.

Descripción general

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

• Chicago

• Nueva York

• San Francisco

• Los Ángeles

• Y otras entidades gubernamentales

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

Related MCP server: json-mcp-server

Características

Con este servidor MCP, los clientes pueden:

• Busque y descubra conjuntos de datos por palabra clave, categoría o etiquetas

• Ver metadatos del conjunto de datos e información de columnas

• Ejecute 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 sencilla de utilizar este servidor MCP es con npx, que no requiere ninguna instalación:

1. Crea o edita tu configuración de Claude Desktop :

   Cree o edite claude_desktop_config.json en su directorio de inicio:

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

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

2. Reinicie Claude Desktop (si ya estaba ejecutándose)

3. Comience a utilizar 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 más en detalle:

   Which make and color were towed the most?
   Also, were there any interesting vanity plates?

   La primera vez que ejecute una consulta, npx descargará y ejecutará automáticamente la última versión del servidor.

Instalación manual desde la fuente

Si prefiere ejecutar desde la fuente (para desarrollo o personalización):

1. Clonar este repositorio :

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

2. Instalar dependencias y compilar :

   npm install
   npm run build

3. Crear la configuración de Claude Desktop :

   Cree o edite claude_desktop_config.json en su 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"
         }
       }
     }
   }

   Reemplace /path/to/your/opengov-mcp-server con la ruta real donde clonó el repositorio.

4. Reinicie Claude Desktop (si ya estaba ejecutándose)

Herramienta disponible: get_data

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

Parámetros

• type (cadena, obligatorio): Tipo de operación

  • catalog : buscar y listar conjuntos de datos

  • categories : Lista de categorías de conjuntos de datos

  • tags : Lista de etiquetas del conjunto de datos

  • dataset-metadata : Obtener detalles del conjunto de datos

  • column-info : Obtener información de la columna 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 de 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 la 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 sus variables de entorno

• A través de la línea de comandos: DATA_PORTAL_URL=https://data.cityofchicago.org opengov-mcp-server