RMI Utility Transition Hub — MCP-сервер

MCP-сервер, загружающий публичные данные RMI Utility Transition Hub в DuckDB. Любой MCP-клиент (Claude Code, Claude Desktop) может с помощью естественного языка запрашивать данные о выбросах энергокомпаний США, структуре генерации и соответствии климатическим целям.

Установка

1. Установка зависимостей

pip install fastmcp duckdb pandas pymupdf

Или через uv:

uv init rmi-mcp-uth
cd rmi-mcp-uth
uv add fastmcp duckdb pandas pymupdf

2. Загрузка данных RMI

Скачайте данные с Utility Transition Hub и распакуйте их в каталог data/ рядом с server.py:

mkdir data
cd data

curl -LO https://utilitytransitionhub.rmi.org/static/data_download/data_download_all_pt_1.zip
curl -LO https://utilitytransitionhub.rmi.org/static/data_download/data_download_all_pt_2.zip

unzip data_download_all_pt_1.zip
unzip data_download_all_pt_2.zip

3. Тестирование с MCP Inspector

npx @modelcontextprotocol/inspector python server.py

Откроется браузерный интерфейс, в котором можно вызывать каждый инструмент, просматривать ресурсы и изучать трафик протокола.

4. Подключение клиента

Сервер использует транспорт stdio. Подключиться к нему может любой MCP-клиент. Ниже приведены конфигурации для Claude Code и Claude Desktop.

Если вы используете uv, укажите клиенту на uv и дайте ему самому настроить окружение. Без uv укажите клиенту на интерпретатор python, в котором установлены зависимости, и в обоих случаях используйте абсолютный путь.

Claude Code

Добавьте сервер с помощью CLI:

claude mcp add rmi-mcp-uth -- uv --directory /absolute/path/to/rmi-mcp-uth run server.py

Или без uv:

claude mcp add rmi-mcp-uth -- python /absolute/path/to/server.py

По умолчанию это local-сервер: он доступен только вам в том каталоге, из которого вы запустили команду. Используйте --scope user, чтобы сделать его доступным во всех проектах, или --scope project, чтобы создать файл .mcp.json, который сохраняется в git и доступен соавторам:

claude mcp add rmi-mcp-uth --scope project -- uv --directory /absolute/path/to/rmi-mcp-uth run server.py

Проверьте подключение:

claude mcp list

Вы должны увидеть rmi-mcp-uth: ... - ✔ Connected. Внутри сессии /mcp выводит список инструментов, ресурсов и промптов сервера. Промпты отображаются как слэш-команды (/mcp__rmi-mcp-uth__decarbonization_assessment), а ресурсы можно прикреплять с помощью @rmi-mcp-uth:rmi://data-dictionary.

Чтобы удалить его: claude mcp remove rmi-mcp-uth.

Claude Desktop

Добавьте это в файл конфигурации Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rmi-mcp-uth": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/rmi-mcp-uth", "run", "server.py"]
    }
  }
}

Или без uv:

{
  "mcpServers": {
    "rmi-mcp-uth": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

Перезапустите Claude Desktop. В поле ввода сообщения появится значок молотка. Нажмите на него, чтобы увидеть свои инструменты.

Related MCP server: US ISO Grid MCP

Что доступно

Инструменты

Ресурсы

Промпты

Примеры диалогов

• «У каких энергокомпаний Колорадо самые высокие выбросы CO2?»

• «Покажи динамику выбросов Xcel Energy за последнее десятилетие»

• «Сравни структуру генерации Duke Energy и Southern Company»

• «Какие энергокомпании дальше всего от траектории 1.5°C?»

• «Какая доля генерации энергокомпаний США приходится на возобновляемые источники?»

Пересоздание базы данных

Удалите utility_hub.duckdb и перезапустите сервер. Он автоматически пересоздаст базу данных из CSV-файлов.

Лицензия на данные

Данные RMI Utility Transition Hub распространяются по лицензии CC BY 4.0.