Сервер OpenGov MCP

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

Обзор

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

• Чикаго

• Нью-Йорк

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

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

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

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

Related MCP server: json-mcp-server

Функции

С помощью этого сервера 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:

// Find datasets about budgets
{
  "type": "catalog",
  "query": "budget",
  "limit": 5
}

// Get information about a dataset
{
  "type": "dataset-metadata",
  "datasetId": "6zsd-86xi"
}

// Query dataset records with SQL-like syntax
{
  "type": "data-access",
  "datasetId": "6zsd-86xi",
  "soqlQuery": "SELECT * WHERE amount > 1000 ORDER BY date DESC",
  "limit": 10
}

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

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

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

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

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

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

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