opengov-mcp-server

Сервер 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