Сервер OpenGov MCP

Сервер MCP (Model Context Protocol), который позволяет клиентам MCP, таким как Claude Desktop, получать доступ к API Socrata Open Data. Эта интеграция позволяет Claude Desktop искать, извлекать и анализировать общедоступные наборы данных из правительственных порталов данных.

Обзор

Этот сервер MCP обеспечивает доступ к открытым данным с любого портала данных, работающего на базе Socrata, включая данные из городов, штатов и федеральных агентств, таких как:

• Чикаго

• Нью-Йорк

• Сан-Франциско

• Лос-Анджелес

• И другие государственные структуры

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

Функции

С помощью этого сервера MCP клиенты могут:

• Поиск и обнаружение наборов данных по ключевым словам, категориям или тегам

• Просмотр метаданных набора данных и информации о столбцах

• Выполнять SQL-подобные запросы для извлечения и анализа данных

• Получить статистику использования портала

Установка для Claude Desktop

Быстрая настройка с помощью npx (рекомендуется)

Самый простой способ использовать этот MCP-сервер — с помощью npx, который не требует установки:

1. Создайте или отредактируйте конфигурацию Claude Desktop :

   Создайте или отредактируйте claude_desktop_config.json в вашем домашнем каталоге:

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

   Вы можете заменить DATA_PORTAL_URL на любой портал данных, работающий на базе Socrata.

2. Перезапустите Claude Desktop (если он уже был запущен)

3. Начните использовать сервер MCP :

   В Claude Desktop теперь вы можете задавать такие вопросы, как:

   How many cars were towed in Chicago this month?

   и вы можете задать дополнительные вопросы, которые позволят вам более подробно рассмотреть:

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

   При первом запуске запроса npx автоматически загрузит и запустит последнюю версию сервера.

Ручная установка из источника

Если вы предпочитаете запускать из исходного кода (для разработки или настройки):

1. Клонируйте этот репозиторий :

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

2. Установите зависимости и соберите :

   npm install npm run build

3. Создайте конфигурацию Claude Desktop :

   Создайте или отредактируйте claude_desktop_config.json в вашем домашнем каталоге:

   { "mcpServers": { "opengov": { "command": "node", "args": [ "/path/to/your/opengov-mcp-server/dist/index.js" ], "env": { "DATA_PORTAL_URL": "https://data.cityofchicago.org" } } } }

   Замените /path/to/your/opengov-mcp-server на фактический путь, по которому вы клонировали репозиторий.

4. Перезапустите Claude Desktop (если он уже был запущен)

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

Этот сервер MCP предоставляет унифицированный инструмент get_data , который Claude Desktop использует для доступа к данным Socrata.

Параметры

• type (строка, обязательно): Тип операции

  • catalog : поиск и составление списка наборов данных

  • categories : Список категорий наборов данных

  • tags : Список тегов набора данных

  • dataset-metadata : Получить сведения о наборе данных

  • column-info : Получить информацию о столбце набора данных

  • data-access : Запрос и извлечение записей

  • site-metrics : Получить статистику портала

• domain (строка, необязательно): имя хоста портала данных (без протокола)

• query (строка, необязательно): Поисковый запрос для наборов данных

• datasetId (строка): идентификатор набора данных для определенных операций

• soqlQuery (строка, необязательно): запрос SoQL для фильтрации данных

• limit (число, необязательно): Максимальное количество возвращаемых результатов (по умолчанию: 10)

• offset (число, необязательно): результаты, которые нужно пропустить при разбивке на страницы (по умолчанию: 0)

Примеры запросов

Вот примеры того, как Claude Desktop будет форматировать запросы к серверу MCP:

Параметры конфигурации

Серверу требуется одна переменная среды:

• DATA_PORTAL_URL : URL-адрес портала данных Socrata (например, https://data.cityofchicago.org )

Это можно установить:

• В конфигурации Claude Desktop (рекомендуется)

• В переменных вашего окружения

• Через командную строку: DATA_PORTAL_URL=https://data.cityofchicago.org opengov-mcp-server