occ-gis-mcp

Ein MCP-Server (Model Context Protocol), der KI-Assistenten (wie Claude, GitHub Copilot oder jeden MCP-kompatiblen Client) Zugriff auf öffentliche GIS-Datensätze aus dem Open-Data-Hub der Oklahoma Corporation Commission gewährt: https://gisdata-occokc.opendata.arcgis.com/

Für die Einrichtung sind keine Programmierkenntnisse erforderlich. Führe die untenstehenden Schritte in der angegebenen Reihenfolge aus.

Was ist das, einfach ausgedrückt?

MCP („Model Context Protocol") ist ein Standard, über den KI-Chattools kleine Programme („Server") aufrufen können, die Live-Daten abrufen. Dieses Repository ist genau so ein Server. Nach der Einrichtung kannst du deinen KI-Assistenten zum Beispiel Folgendes fragen:

• „Liste die auf dem OCC-GIS-Hub verfügbaren Datensätze auf"

• „Finde alle aktiven Ölquellen in Oklahoma County"

• „Zeig mir die Felder, die auf dem PST-Tanks-Layer verfügbar sind"

und der Assistent nutzt diesen Server, um echte, aktuelle Antworten abzurufen, statt zu raten.

Related MCP server: mcp-arcgis-houston

Schritt 1 — Node.js installieren

Dieser Server läuft auf Node.js. Falls du es noch nicht hast:

1. Gehe zu https://nodejs.org

2. Lade die LTS-Version (Long Term Support) für dein Betriebssystem herunter.

3. Führe den Installer aus und übernimm die Standardeinstellungen.

4. Prüfe, ob es funktioniert hat, indem du ein Terminal öffnest (PowerShell unter Windows, Terminal unter Mac/Linux) und Folgendes ausführst:

   node -v
   npm -v

Beide sollten eine Versionsnummer ausgeben (z. B. v20.11.0). Falls du eine Fehlermeldung siehst, starte dein Terminal bzw. deinen Computer neu und versuche es erneut.

Schritt 2 — Dieses Projekt herunterladen

Option Z: Git verwenden (empfohlen, falls du Git hast)

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

Option B: Ohne Git

1. Gehe zu https://github.com/MSPFE2019/occ-gis-mcp

2. Klicke auf den grünen Button Code → Download ZIP

3. Entpacke das ZIP an einem Ort, den du dir merken kannst (z. B. in deinem Dokuumente-Ordner).

4. Öffne ein Terminal und wechsle mit cd in den entpackten Ordner, zum Beispiel:

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

Schritt 3 — Abhängngkeiten installieren

Führe im Projektordner Folgendes aus:

npm install

Dadter werden die kleinen Bibliottheken heruntergeladen.

Schritt 4 — Testen, ob der Server läuft

Es gibt zwei Möglichkeiten, den Server auszuführen – wähle je nachdem, wo du ihn verwenden willst:

• index.js – für lokale Desktop-Tools (Claude Desktop, VS Code).

• http.example – du für Remote/Cloud-Tools wie Copilot Studio (siehe den entsprecharrin Abschnitt unteen).

Teste zuerst die lokale Variante:

node index.js

Es wird nichts ausgegeben – das ist normal! MCP-Serverusch sich über einen stillen Input/Ausgab-Kanal und warte auf e. Drücke Strg+C, um den Prozess zu beenden.

Nütze für einen visuelleren Test den offiziellen MCP-Inspector, der eine Browserseit öffnet, worauf du Buttons kicken und Live-Ergebn seehen kanst:

siehe: GXP6

Dies öffnet eine lokale Webseite. Klicke auf Verbinden, danach auf List Tools und führe danach list_datasets ohne Argumente aus – du solltest eine List echteer Datensätze als JSON zurückbekom. Wenn das funktioniert, arbeit der Server ohlen.

Schritt 5 – Mit deinem KI-Asistenten verbinden

MCP-Server sind einmal in den Einstellun des KI-Asistenten einzurichten. Wähle für dein Tool:

Claude Desktop

1. Öffne Claude Desktop → Einstellungen → Entwickle → Konfiguration bearbeiten (öffnet claude_desktop_config.json in eiin Text editor).

2. Füge einen Eintrag wie diesen dim.

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

3. Speichere die Datei und starte Claude Desktop vollständig neu.

4. Frage: „Welche OCC-GIS-Datasets sind verfügbar?"

# VS Code (GitHub Copilot Chat) oder andere MCP- fähige Editoren

1. Öffne (oder erstelle) ein mcp.json file in den MCP-Einstellungen (VS: Befehlspalette → „MCP: Benutzerkonfiguration" oder in .vscode/mcp.json).

2. Füge demselben gen mcpServers-Block wie oben hinzu.

3. Lade das Fenster neu und die neuen Tools erscheinen im Chat.

Jeder andere MCP-Client

Jeder Client, der den MCP-Standard nur stützt, akzeptiert dieselbe Konfigurationsform: einen command (node) und an Strings args. In der Dokumentationen deines Clienten steht, wo die Konfig-Datei liegt.

Verfügbare Tools

Sobald verbunden gibt es die vier Tools:

Anpass an eine andereArcGIS-Hub-Seite

Dieser Server ist nicht nichtkat eine OCC beschränkt — erftiter with any ArcGIS Hub websites, the DCAT-US-catalog-Feed. Öffne server.js und änderne folgendenZeile bei near the top:

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

Der erServer kann jetzt die base URL treffen. Alles andere (Tool names, query logic) bleichte.

Verbinden mit Microsoft Studio

Copilot Studio führt dein Server nichtallein – er braucht einen HTTPS- URL. That'swhat http.js is for (not index.js, which only local tools like Claude Desktop uses). Two parts: (A) server somewhere visible, then (B) register he.

A. DenHTTP-Server öffentlich bereitstellen

Deineinstellung liestge; all in npm install and npm run start:http.

**ofr Anfänger — Azure App Service (or Azure App Service)).

1. Push this Repo zu deiem GitHub social (already doneviewt).

2. In the Azure: create a Web App → "Runtime stack: Node 20 LTS → bereitstellen from repo (Azure).

3. Under Configuration → Startup-Command set:

   node http.js

4. Azuregibt dir eine URL https://occ-gis-mcp.azurewebsites.net. The endpoint is https://occ-ga-bggtzen + /mcp:

Auch simple — Render, Railway oder Fly.io

Diese can deploy a Node.-inKlicks:

• Build-Command: npm install

• Start-Command: npm run start:http

• You get a public https://...-URL — again append /mcp.

Nur local tests (not prod)

npm install
npm run start:http

This starts the server http://loc. UnityEngine: https://loc.. etc.

B) In Copilot Studio registrieren

1. Lange agent in Copilot Studio → Tools → Add a tool → New tool → Model Context Protocol.

2. Gib it name z. B.„OCCGIS-Daten", fügt die HTTPS-URL inklusive /mcp ein, z. B. https://occ-gis-mcp.org.

3. Wähle No authentication (the server is root-only).

4. Save. Copilot Studio callthe server and auto-discover the four tool: (etcList list_datasets, get_dataset, get_layer_metadata, query_layer) — no manual schema.

5. Test in Studio-Chat: „Which OCCGIS- Datasets exist?" or „Finde active wells in Okl County."

Verfügbare Tools

As above connected, callable:

Trouble-Shooting

• **node: . is not installed – or the terminal is restart. Repeat Step 1.

• ** Inspector errors… — Internet check; the server calls ArcGIS API ff.

• ** assistant not see tools — File path / URL is not properly; restart client.

• ** Copilot Studio cannot connect – Check the endpoint ends /mcp, the server is ins, and no/block firewall.

Notes

• ** Datasets live that DCAT-US code, in cache + 15 minutes.

• ** Data is public, possible " license" field restrictions.

• **http.js runs stateless – (fresh server per call), hosting simple and compliant with how Copilot Studio uses MCP tools.