occ-gis-mcp

MCP-сервер (Model Context Protocol), который даёт AI-ассистентам (например, Claude, GitHub Copilot или любому MCP-совместимому клиенту) доступ к публичным ГИС-данным из открытого хаба данных Корпорационной комиссии штата Оклахома: https://gisdata-occokc.opendata.arcgis.com/

Для настройки не требуется опыта в программировании. Просто выполните шаги ниже по порядку.

Что это, если простыми словами?

MCP (Model Context Protocol) — это стандарт, с помощью которого AI-чат-инструменты могут вызывать небольшие программы («серверы») и получать актуальные данные. Этот репозиторий и есть один из таких серверов. После настройки вы сможете просить своего AI-ассистента о таких вещах:

• «Перечисли наборы данных, доступных на ГИС-хабе OCC»

• «Найди все активные нефтяные скважины в округе Оклахома»

• «Покажи, какие поля доступны на слое PST Tanks»

и ассистент использует этот сервер, чтобы получить реальные, актуальные ответы, а не догадываться.

Related MCP server: mcp-arcgis-houston

Шаг 1 — Установите Node.js

Этот сервер работает на Node.js. Если он у вас ещё не установлен:

1. Перейдите на https://nodejs.org

2. Скачайте версию LTS (Long Term Support) для vaшей операционной системы.

3. Запустите установщик и согласитесь с параметрами по умолчанию.

4. Убедитесь, что всё получилось. Откройте терминал (PowerShell в Windows или Terminal на Mac/Linux) и выполните:

node -v
npm -v

Обе команды должны вывести номер версии (например, v20.11.0). Если появляется ошибка, перезагрузите терминал/компьютер и попробуйте снова.

Шаг 2 — Скачайте этот проект

Вариант A: через Git (рекомендуется, если Git установлен)

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

Вариант B: без Git

1. Перейдите на https://github.com/MSPFE2019/occ-gis-mcp

2. Нажмите зелёную кнопку Code → Download ZIP

3. Распакуйте архив в место, которое вы запомните (например, в папку «Документы»)

4. Откройте терминал и перейдите через cd в распакованную папку, например:

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

Шаг 3 — Установите зависимости

Выполните из папки проекта:

npm install

Эта команда загрузит небольшие библиотеки, которые нужны серверу. Она выполняется один раз (и ещё раз, если код изменится).

Шаг 4 — Проверка, что сервер запускается

Запустить сервер можно двумя способами — выберите тот, который подходит для вашего сценария использования:

• index.js — для локальных инструментов (Claude Desktop, VS Code/Copilot Chat).

• http.js — для удалённых/облачных инструментов, таких как Copilot Studio (см. специальный раздел ниже).

Сначала попробуйте локальный вариант:

node index.js

Ничего не выведется — это нормально! MCP-серверы работают через «молчаливый» канал ввода/вывода и просто ждут подключения клиента. Нажмите Ctrl+C, чтобы остановить его.

Для более наглядной проверки используйте официальный MCP Inspector. Он открывает веб-страницу с кнопками и живыми результатами:

npx @modelcontextprotocol/inspector node index.js

Откроется локальная веб-страница. Нажмите Connect, затем List Tools, а потом попробуйте выполнить list_datasets без аргументов — вы должны увидеть список реальных наборов данных в формате JSON. Если это работает, сервер настроен правильно.

Шаг 5 — Подключение к вашему AI-ассистенту

MCP-серверы настраивается один раз в настройках вашего AI-клиента. Выберите подходящую инструкцию:

Claude Desktop

1. Откройте Claude Desktop → Settings → Developer → Edit Config (откроется файл claude_desktop_config.json в текстовом редакторе).

2. Добавьте запись такого вида (замените путь на вашу реальную папку проекта, используя в Windows двойной обратный слэш \\ на Windows):

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

3. Сохраните файл и полностью перезапустите Claude Desktop.

4. Спросите ассистента: «Какие наборы ГИС-данных OCC доступны?»

VS Code (GitHub Copilot Chat) или другие редакторы с поддержкой MCP

1. Откройте (или создайте) файл mcp.json в настройках MCP (в VS Code: Command Palette → «MCP: Open User Configuration», или добавьте его в .vscode/mcp.json вашего рабочего пространства).

2. Добавьте тот же блок mcpServers, что показан выше.

3. Перезагрузите окно, новые инструменты появятся при работе с Copilot.

Любой другой MCP-клиент

Любой клиент, который поддерживает стандарт MCP, принимает конфигурацию той же формы: command (node) и args (полный путь к index.js). Где находится этот файл конфигурации, указано в документации вашего клиента.

Доступные инструменты

После подключения ассистент сможет вызывать следующие команды:

Настройка сервера для другого ArcGIS Hub сайта

Этот сервер не ограничен данными OCC — он работает с любым сайтом ArcGIS Hub, который отдаёт каталог DCAT-US (большинство публичных ArcGIS Hub-сайтов). Для другой площадки откройте server.js and change this line near the top:

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

на базовый URL целевого сайта и перезапустите сервер. Все остальные элементы (имена инструментов, логика запросов) работают так же.

Подключение к Microsoft Copilot Studio

Copilot Studio не запускает этот сервер за вас — для работы имени требуется доступ через интернет в виде HTTPS-URL. Для этого нужен http.js (в отличие от index.js, предназначено только для локальных инструментов таких, как Claude Desktop). Здесь двух шага: (A) поместите сервер в место, доступное через Интернет, затем (B) зарегистрируйте его в Copilot Studio.

A. Разверните HTTP-сервер в публичном месте

Выберите то, что вам проще — вез используется одна и та же команда: npm install, затем npm run start:http.

Самый просто вариант — Azure App Service (или Azure Container Apps)

1. Запушьте этот репозиторий в свой GitHub-аккаунт (если вы читаете это из своего форка или копии, это уже сделано).

2. В Azure Portal создайте Web App → Runtime stack: Node 20 LTS → разверните из своего GitHub-репозитория (Azure настроит CI/CD за вас).

3. В разделе Configuration → Startup Command укажите:

GXP9 4. После развёртывания Azure выдаст вам URL вида https://occ-gis-mcp.azurewebsites.net. Ваш MCP-эндпоинт — это этот URL плюс /mcp, например https://occ-gis-mcp.azurewebsites.net/mcp.

Тоже просто — Render, Railway или Fly.io Любой из этих сервисов может развернуть Node.js-репозиторий с GitHub в несколько кликов:

• Build-команда: npm install

• Start-команда: npm run start:http

• Они выдают публичный URL https://... — снова добавьте /mcp.

Только для локального тестирования (не для продакшена)

npm install
npm run start:http

Это запускает сервер на http://localhost:3000/mcp. Для проверки доступа из Copilot Studio (облачного сервиса) к вашему локальному коду нужен туннель, например ngrok (ngrok http 3000), который даст временный публичный HTTPS-адрес. Это подходит для быстрой демонстрации, но не для постоянного использования.

Б. Зарегистрируйте его в Copilot Studio

1. Откройте своего агента в Copilot Studio → перейдите в Tools (или Actions) → Add a tool → New tool → ModelContextProtocol.

2. Присвойте имя (например «OCC GIS Data») и вставьте HTTPS-URL вашего сервера вместе с /mcp, например https://occ-gis-mcp.azurewebsites.net/mcp.

3. Выберите No authentication (сервер работает только на чтение и не требует учётных данных), если только вы уже не добавили собственный слой аутентификации перед ним.

4. Сохраните. Copilot Studio вызовет сервер иAutomatically найдёт четыре инструменты (list_datasets, get_dataset, get_studio, query_layer) вместе с их описаниями — записывать схему вручную не нужно.

5. Проверьте в панели тестового чата Copilot Studio: спросите «Какие наборы ГИС-данных OCC доступны?» или «Find active wells in Oklahoma ».

Available Tools

The client's list of available tools is an extension of the previous table? Actually need same heading.

Доступные инструменты

После подключения ассистент может вызывать эти команды:

В списке восемь? Actually it's a repeat; okay fine.

Что сделать, если что-то не получается

• node: command not found — Node.js не установлен или после установки не перезагружен терминал. Повторяйте Шаг 1.

• Ошибки во время Inspector/tool call с упоминанием network/fetch — есть ли интернет-соединение: сервер обращается к живому ArcGIS Hub API при каждом запросе.

• Ассистент doesn't видит новые инструменты — перепроверьте, правильный ли указан путь к файлу (локально) или URL (в Copilot Studio), и полностью ли вы перезапустили/переподключили клиент.

• Copilot Studio says it can't connect — проверьте, что URL зарегистрирован с /mcp на конце (a не просто домен), что развертывание реально запущено, и что сервис доступен по обычному HTTPS (нет блокирующего VPN/брандмауэра).

Примечания

• Список наборов данных загружается live из DCAT-US каталога хаб-хаб и кэшируется на 15 минут для скорости.

• Данные открыты, но подчиняются условиям использования источника-владельца (эту информацию можно увидеть в поле license в выводе get_dataset).

• http.js работает в stateless-режиме (новый сервер на каждый запрос), что упрощает хостинг и полностью совместимо со способом вызова MCP-инструментов в Copilot Studio.