Data ChileGob

by gerardbourguett

Not rated
GitHub

About

MCP server exposing Chile's open government dataset portal (datos.gob.cl / CKAN API v3)

Details

Author
gerardbourguett
Categories
Database, Other, API

Setup

Install Data ChileGob in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/gerardbourguett/mcp-chilegob-dataset

Follow the installation instructions in the repository README, then restart your MCP client.

English summary:MCP server that exposes Chile's open government data portal (datos.gob.cl) as tools for AI assistants. Search and read thousands of public datasets from Chilean government institutions — health, education, transport, environment, and more. No API key required.

Servidor MCP que expone el portal de datos abiertos del gobierno de Chile —datos.gob.cl— como herramientas para asistentes de inteligencia artificial.

Construido conHonoy elSDK de TypeScript del Model Context Protocol.

ElModel Context Protocol (MCP)es un estándar abierto que permite a los asistentes de IA (Claude, etc.) conectarse a herramientas y fuentes de datos externas de manera estructurada y segura. En lugar de copiar datos crudos en una conversación, el asistente llama a una herramienta y recibe resultados estructurados.

datos.gob.cles el portal oficial de datos abiertos del gobierno de Chile, impulsado porCKAN. Contiene miles de datasets públicos de instituciones gubernamentales — salud, educación, transporte, medio ambiente, y más. Todos los datos son de acceso público, sin registro ni autenticación.

Paso 1— Abre la configuración de Claude Desktop.

En Mac:~/Library/Application Support/Claude/claude_desktop_config.jsonEn Windows:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "chilegob": { "command": "npx", "args": ["-y", "mcp-chilegob-dataset"] } } }

Paso 3— Reinicia Claude Desktop. La primera vez descarga el paquete automáticamente.

Eso es todo. Puedes pedirle a Claude cosas como:

"Busca datasets sobre educación en datos.gob.cl""Muestra los datos del dataset de matrícula universitaria""¿Qué datasets de salud hay disponibles?"

Este servidor expone tres herramientas que el asistente puede usar automáticamente.

Busca datasets en datos.gob.cl por palabra clave. Devuelve una lista resumida.

[ { "id": "matricula-en-educacion-superior", "title": "Matrícula en Educación Superior", "description": "Bases de datos de matrícula en el sistema de educación superior...", "organization": "Subsecretaría de Educación", "resource_count": 1 } ]

Obtiene los metadatos completos de un dataset: descripción, recursos, etiquetas y licencia.

{ "id": "matricula-en-educacion-superior", "title": "Matrícula en Educación Superior", "organization": "Subsecretaría de Educación", "license": "Creative Commons Non-Commercial (Any)", "tags": ["educación", "educación superior", "matriculas"], "resources": [ { "id": "37377aff-6df8-4424-9228-2f44f3e67fcd", "name": "Base de datos de matrícula", "format": "CSV", "url": "https://datosabiertos.mineduc.cl/...", "datastore_available": true } ] }

Verifica el campodatastore_availableantes de usarget_resource_data. Los recursos sin datastore deben descargarse desde suurl.

Lee filas tabulares de un recurso CKAN. Intenta primero el datastore y, si no está disponible, descarga y parsea el archivo directamente. Soporta paginación.

Estrategia de obtención de datos (automática):
- Datastore CKAN— acceso estructurado y rápido; disponible solo en algunos recursos.
- Descarga directa— si el datastore no está habilitado, la herramienta descarga el archivo y lo parsea en memoria:

- CSV/TSV— parseado nativo, devuelve filas y columnas.

- JSON— parseado nativo si el contenido es un array de objetos.
- XLS,PDFy otros formatos binarios — no se parsean; se devuelve la URL directa para que el usuario los descargue.

{ "source": "datastore", "total": 42, "returned": 3, "offset": 0, "fields": [ { "id": "Region", "type": "text" }, { "id": "Provincia", "type": "text" }, { "id": "Comuna", "type": "text" } ], "records": [ { "Region": "COQUIMBO", "Provincia": "ELQUI", "Comuna": "LA SERENA" } ] }

Ejemplo de respuesta (archivo CSV descargado):

{ "source": "file", "format": "CSV", "url": "https://datosabiertos.mineduc.cl/...", "total": 1500, "returned": 50, "offset": 0, "fields": [ { "id": "Region", "type": "text" } ], "records": [ { "Region": "METROPOLITANA" } ] }

Ejemplo de respuesta (formato no parseable):

{ "source": "file", "parseable": false, "format": "XLS", "url": "https://datosabiertos.mineduc.cl/archivo.xls", "message": "This resource is a XLS file and cannot be parsed automatically. Download it directly from the URL provided." }
git clone https://github.com/gerardbourguett/mcp-chilegob-dataset.git cd mcp-chilegob-dataset npm install

Con el servidor corriendo (npm run dev), abre otra terminal y ejecuta:

Se abre una interfaz web enhttp://localhost:6274. Configura:

- Transport type:Streamable HTTP
- URL:http://localhost:3000/mcp

Desde ahí puedes llamar a cualquier herramienta de forma interactiva y ver las respuestas.

Cliente AI → Hono HTTP → McpServer → CKAN API v3 (datos.gob.cl)
src/ ├── index.ts # Servidor HTTP (para desarrollo y despliegue remoto) ├── stdio.ts # Transporte stdio (para npx y Claude Desktop) ├── server.ts # Instancia McpServer + registro de herramientas ├── ckan.ts # Cliente tipado para la API CKAN v3 └── tools/ ├── search.ts # search_datasets ├── dataset.ts # get_dataset └── resource.ts # get_resource_data

- Creasrc/tools/tu-herramienta.ts
- Impórtala y regístrala ensrc/server.ts

// src/tools/tu-herramienta.ts import type { McpServer } from '@modelcontextprotocol/server' import { z } from 'zod' export function registerTuHerramienta(server: McpServer): void { server.registerTool( 'nombre_herramienta', { title: 'Nombre visible en el cliente', description: 'Descripción clara. El asistente la usa para decidir cuándo llamar esta herramienta.', inputSchema: z.object({ parametro: z.string().describe('Descripción del parámetro'), }), }, async ({ parametro }) => { // tu lógica aquí return { content: [{ type: 'text', text: JSON.stringify({ resultado: parametro }) }], } } ) }

- Disponibilidad del datastore— No todos los recursos tienen datastore habilitado en CKAN.get_resource_dataintenta automáticamente descargar el archivo (CSV, TSV, JSON); los formatos binarios (XLS, PDF) requieren descarga manual desde la URL devuelta.
- Archivos grandes— La descarga directa carga el archivo completo en memoria antes de paginar. Para archivos muy grandes (>100 MB) esto puede ser lento o fallar.
- Encoding— Los archivos CSV de datos.gob.cl pueden estar en ISO-8859-1 (Latin-1). La herramienta intenta leerlos como UTF-8; si los caracteres aparecen corruptos, descarga el archivo directamente.
- Caché en memoria (5 min)search_datasetsyget_datasetusan caché en memoria con TTL de 5 minutos.get_resource_datasiempre consulta en vivo. No hay límites de tasa documentados en datos.gob.cl.
- Timeout de red (10s)— Todas las solicitudes a datos.gob.cl tienen un timeout de 10 segundos. Si el portal está lento o caído, las herramientas devuelven un error claro en lugar de colgar indefinidamente.
- Paquetes en alpha@modelcontextprotocol/honoy@modelcontextprotocol/serverestán en versión alpha.

Las contribuciones son bienvenidas. Algunas ideas:

- Herramientalist_organizations— listar instituciones disponibles
- Herramientaget_resource_schema— tipos y descripciones de columnas
- MCP Resources con URI templates (datos-gob-cl://dataset/{id})

Por favor, abre un issue antes de enviar un PR grande.

Access comprehensive U.S. Congressional data, including bills, votes, and member information, via the Congress.gov API.

Access Israeli Government Open Data from the data.gov.il portal.

A Centralized MCP Server for Fetching Data from Many Countries' Govs

Access Socrata Open Data APIs from government data portals.

MCP server for Indian APIs — GSTIN, IFSC, PAN, UPI, pincode, HSN/SAC. Zero auth. Offline-first. For AI agents.

Provides real-time financial market data using the Alpha Vantage API.

A stock market data service for querying A-share market data from Sina and Tencent Finance.

Access live U.S. congressional data from the Congress.gov API.

A read-only MCP server for querying live data from various APIs using the CData JDBC Driver for API Driver.

Query and manage data through CData Connect Cloud, providing a unified interface to various data sources.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.