MCP-сервер Socrata

MCP-сервер, который дает Claude инструменты для исследования и запроса данных с любого портала открытых данных Socrata.

Инструменты

Related MCP server: mcp-data-kcmo

Установка

Предварительные требования

Вам необходим Python 3.10 или новее. Проверьте свою версию:

python3 --version

Если вам нужно установить или обновить Python:

• macOS: brew install python (требуется Homebrew)

• Ubuntu/Debian / WSL: sudo apt update && sudo apt install -y python3 python3-venv python3-pip

• Fedora/RHEL: sudo dnf install python3

• Windows 11 native: Скачайте с python.org и отметьте Add to PATH во время установки

1. Клонируйте или скопируйте эту папку

git clone https://github.com/your-username/socrata-mcp.git
cd socrata-mcp

Или просто скопируйте файлы server.py и requirements.txt в выбранную вами папку.

2. Создайте виртуальное окружение

python3 -m venv .venv

3. Активируйте виртуальное окружение

Ваша командная строка изменится, отображая (.venv), когда окружение будет активно.

4. Установите зависимости

pip install -r requirements.txt

5. Проверьте установку

python3 server.py --help

Вы должны увидеть ошибку вроде:

RuntimeError: SOCRATA_DOMAIN environment variable is required

Это означает, что сервер загрузился правильно — ему просто нужно настроить ваши учетные данные (см. ниже).

Конфигурация

Обе переменные окружения обязательны. Сервер не запустится без них.

Чтобы получить API-токен: войдите на свой портал Socrata → Developer Settings → Create New App Token.

Добавление в Claude Desktop

Claude Desktop считывает список своих MCP-серверов из JSON-файла конфигурации. Отредактируйте файл для вашей платформы:

macOS / Linux (native)

{
  "mcpServers": {
    "socrata": {
      "command": "/absolute/path/to/socrata-mcp/.venv/bin/python3",
      "args": ["/absolute/path/to/socrata-mcp/server.py"],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

Замените /absolute/path/to/socrata-mcp на реальный путь. Найдите его, выполнив pwd внутри папки проекта.

Windows 11 (native Python)

{
  "mcpServers": {
    "socrata": {
      "command": "C:\\Users\\YourName\\socrata-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\YourName\\socrata-mcp\\server.py"],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

Windows 11 с WSL

Claude Desktop работает в Windows, но может запускать процесс WSL через wsl.exe:

{
  "mcpServers": {
    "socrata": {
      "command": "wsl.exe",
      "args": [
        "--exec",
        "/home/your-wsl-username/socrata-mcp/.venv/bin/python3",
        "/home/your-wsl-username/socrata-mcp/server.py"
      ],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

Замените your-wsl-username на ваше имя пользователя в WSL (выполните whoami внутри WSL для проверки).

После редактирования конфигурации перезапустите Claude Desktop, и вы увидите доступные инструменты Socrata.

Лицензия

Этот проект лицензирован под лицензией MIT.

Этот код был сгенерирован с использованием Claude от Anthropic.

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

• "Какие наборы данных доступны на портале открытых данных Делавэра?"

• "Покажи мне топ поставщиков по расходам на контракты в 2025 финансовом году"

• "Какие столбцы есть в наборе данных sifm-293u?"

• "Какие агентства потратили больше всего на облачные решения в прошлом году?"

• "Поиск наборов данных по образованию на data.delaware.gov"