occ-gis-mcp

Un servidor MCP (Model Context Protocol) que da a los asistentes de IA (como Claude, GitHub Copilot o cualquier cliente compatible con MCP) acceso a conjuntos de datos GIS públicos del hub de datos abiertos de la Oklahoma Corporation Commission: https://gisdata-occokc.opendata.arcgis.com/

No se requiere experiencia en programación para configurarlo. Sigue los pasos a continuación en orden.

¿Qué es esto, en términos sencillos?

MCP («Model Context Protocol») es una forma estándar de que las herramientas de chat con IA llamen a pequeños programas («servidores») que obtienen datos en vivo. Este repo es uno de esos servidores. Una vez configurado, puedes preguntarle a tu asistente de IA cosas como:

• "Lista los conjuntos de datos disponibles en el hub GIS de la OCC"

• "Encuentra todos los pozos de petróleo activos en el condado de Oklahoma"

• "Muéstrame los campos disponibles en la capa PST Tanks"

y el asistente usará este servidor para obtener respuestas reales y en vivo en lugar de adivinar.

Related MCP server: mcp-arcgis-houston

Paso 1 — Instalar Node.js

Este servidor se ejecuta en Node.js. Si aún no lo tienes:

1. Ve a https://nodejs.org

2. Descarga la versión LTS (Long Term Support) para tu sistema operativo.

3. Ejecuta el instalador y acepta los valores predeterminados.

4. Confirma que funciona abriendo una terminal (PowerShell en Windows, Terminal en Mac/Linux) y ejecutando:

   node -v
   npm -v

Ambos deberían mostrar un número de versión (p. ej., v20.11.0). Si ves un error, reinicia la terminal/ordenador y vuelve a intentarlo.

Paso 2 — Descargar este proyecto

Opción A: Usar Git (recomendado si lo tienes)

git clone https://github.com/MSPFE2019/occ-gis-mcp.git
cd occ-gis-mcp

Opción B: Sin Git

1. Ve a https://github.com/MSPFE2019/occ-gis-mcp

2. Haz clic en el botón verde Code → Download ZIP

3. Descomprímelo en un lugar que recuerdes (p. ej., tu carpeta Documentos)

4. Abre una terminal y cd a esa carpeta descomprimida, por ejemplo:

   cd "C:\Users\YourName\Documents\occ-gis-mcp"

Paso 3 — Instalar las dependencias

Dentro de la carpeta del proyecto, ejecuta:

npm install

Esto descarga las pequeñas bibliotecas que el servidor necesita. Solo necesitas hacerlo una vez (y de nuevo cada vez que cambie el código).

Paso 4 — Probar que funciona

Hay dos formas de ejecutar este servidor — elige según dónde lo vayas a usar:

• index.js — para herramientas locales de escritorio (Claude Desktop, VS Code/Copilot Chat).

• http.js — para herramientas remotas/de nube como Copilot Studio (consulta la sección dedicada más abajo).

Prueba primero el local:

node index.js

No se imprimirá nada: ¡es lo esperado! Los servidores MCP se comunican a través de un canal silencioso de entrada/salida y solo esperan a que un cliente se conecte. Pulsa Ctrl+C para detenerlo.

Para una prueba más visual, usa el Inspector MCP oficial, que abre una página del navegador donde puedes hacer clic en botones y ver resultados en vivo:

npx @modelcontextprotocol/inspector node index.js

Esto abre una página web local. Haz clic en Connect, luego en List Tools y después intenta ejecutar list_datasets sin argumentos — deberías ver una lista de conjuntos de datos reales devuelta como JSON. Si funciona, el servidor está funcionando correctamente.

Paso 5 — Conéctalo a tu asistente de IA

Los servidores MCP se configuran una vez dentro de los ajustes de tu cliente de IA. Elige la guía que coincida con tu herramienta:

Claude Desktop

1. Abre Claude Desktop → Settings → Developer → Edit Config (esto abre claude_desktop_config.json en un editor de texto).

2. Añade una entrada como esta (sustituye la ruta por la carpeta real de tu proyecto, usando dobles barras invertidas \\ en Windows):

   {
     "mcpServers": {
       "occ-gis": {
         "command": "node",
         "args": ["C:\\Users\\YourName\\Documents\\occ-gis-mcp\\index.js"]
       }
     }
   }

3. Guarda el archivo y reinicia Claude Desktop por completo.

4. Pregúntale: "¿Qué conjuntos de datos GIS de la OCC están disponibles?"

VS Code (GitHub Copilot Chat) u otros editores compatibles con MCP

1. Abre (o crea) un archivo mcp.json en tus ajustes de MCP (en VS Code: Paleta de comandos → "MCP: Open User Configuration", o añádelo a .vscode/mcp.json de tu espacio de trabajo).

2. Añade el mismo bloque mcpServers que se muestra arriba.

3. Recarga la ventana y las nuevas herramientas aparecerán cuando chatees con Copilot.

Cualquier otro cliente MCP

Cualquier cliente que admita el estándar MCP acepta la misma forma de configuración: un command (node) y args (la ruta completa a index.js). Consulta la documentación de tu cliente para saber dónde se encuentra ese archivo de configuración.

Herramientas disponibles

Una vez conectado, tu asistente puede llamar a estas:

Personalizar para un sitio de ArcGIS Hub diferente

Este servidor no se limita a los datos de la OCC: funciona con cualquier sitio de ArcGIS Hub que exponga un feed de catálogo DCAT-US (la mayoría de los sitios públicos de ArcGIS Hub lo hacen). Para apuntarlo a un sitio diferente, abre server.js y cambia esta línea cerca del principio:

const HUB_BASE = "https://gisdata-occokc.opendata.arcgis.com";

por la URL base de tu sitio de destino y vuelve a ejecutar el servidor. Todo lo demás (nombres de herramientas, lógica de consulta) funciona igual.

Conexión con Microsoft Copilot Studio

Copilot Studio no ejecuta este servidor por ti; necesita alcanzarlo a través de internet como una URL HTTPS. Para eso sirve http.js (a diferencia de index.js, que es solo para herramientas locales como Claude Desktop). Hay dos partes: (A) colocar el servidor en algún lugar accesible desde internet y luego (B) registrarlo en Copilot Studio.

A. Desplegar el servidor HTTP en un lugar público

Elige la opción que te resulte más fácil: todas ejecutan el mismo comando: npm install y luego npm run start:http.

Lo más fácil para principiantes — Azure App Service (o Azure Container Apps)

1. Sube este repo a tu propia cuenta de GitHub (ya está hecho si estás leyendo esto desde tu fork/copia).

2. En Azure Portal, crea una Web App → Runtime stack: Node 20 LTS → despliega desde tu repositorio de GitHub (Azure configura CI/CD por ti).

3. En Configuration → Startup Command, establece:

   node http.js

4. Una vez desplegado, Azure te da una URL como https://occ-gis-mcp.azurewebsites.net. Tu endpoint MCP es esa URL más /mcp, por ejemplo https://occ-gis-mcp.azurewebsites.net/mcp.

También sencillo — Render, Railway o Fly.io

Cualquiera de ellos puede desplegar un repo de Node.js desde GitHub en unos pocos clics:

• Comando de compilación: npm install

• Comando de inicio: npm run start:http

• Te darán una URL pública https://...; de nuevo, añade /mcp.

Solo para pruebas locales (no para producción)

npm install
npm run start:http

Esto inicia el servidor en http://localhost:3000/mcp. Para probar si Copilot Studio (un servicio en la nube) puede acceder a un servidor en tu propia máquina, necesitarías una herramienta de túnel como ngrok (ngrok http 3000), que te da una URL HTTPS pública temporal. Esto está bien para una demo rápida, no para un uso real o continuado.

B. Registrarlo en Copilot Studio

1. Abre tu agente en Copilot Studio → ve a Tools (o Actions) → Add a tool → New tool → Model Context Protocol.

2. Ponle un nombre (p. ej., "OCC GIS Data") y pega la URL HTTPS de tu servidor incluyendo /mcp, p. ej. https://occ-gis-mcp.azurewebsites.net/mcp.

3. Elige No authentication (este servidor es de solo lectura y no requiere credenciales) a menos que hayas añadido tu propia capa de autenticación delante.

4. Guarda. Copilot Studio llamará al servidor y descubrirá automáticamente las cuatro herramientas (list_datasets, get_dataset, get_layer_metadata, query_layer) junto con sus descripciones: no es necesario introducir ningún esquema manualmente.

5. Pruébalo en el panel de chat de prueba de Copilot Studio: pregunta "¿Qué conjuntos de datos GIS de la OCC están disponibles?" o "Encuentra pozos activos en el condado de Oklahoma".

Herramientas disponibles

Una vez conectado, tu asistente puede llamar a estas:

Solución de problemas

• node: command not found — Node.js no está instalado o tu terminal necesita reiniciarse después de la instalación. Repite el Paso 1.

• Errores del Inspector/llamadas a herramientas que mencionen network/fetch — comprueba tu conexión a internet; el servidor llama a la API en vivo de ArcGIS Hub en cada solicitud.

• El asistente no ve las nuevas herramientas — verifica que la ruta del archivo (local) o la URL (Copilot Studio) sea correcta y que hayas reiniciado/reconectado el cliente por completo.

• Copilot Studio dice que no puede conectarse — asegúrate de haber registrado la URL terminada en /mcp (no solo el dominio desnudo), de que el despliegue se está ejecutando realmente y de que es accesible a través de HTTPS normal (sin VPN/cortafuegos que lo bloqueen).

Notas

• La lista de conjuntos de datos se obtiene en vivo del feed de catálogo DCAT-US del hub y se almacena en caché durante 15 minutos para mantener la velocidad.

• Los datos son públicos pero están sujetos a los términos de uso de la agencia de origen (se muestran en el campo de licencia de la salida de get_dataset).

• http.js se ejecuta en modo sin estado (un servidor nuevo por solicitud), lo que simplifica el alojamiento y es totalmente compatible con la forma en que Copilot Studio llama a las herramientas MCP.