MCP-сервер MeteoControl

Сервер протокола Model Context Protocol (MCP) для API MeteoControl VCOM v2. Это расширение позволяет вам отслеживать солнечные электростанции, получать данные о выработке энергии и выполнять проверки работоспособности системы с помощью естественного языка через Gemini CLI.

Функции

Обнаружение систем: Список всех солнечных систем, связанных с вашей учетной записью.
Мониторинг энергии: Получение исторических данных о выработке энергии (Вт·ч/кВт·ч/МВт·ч).
Информация об активах: Получение технических деталей о панелях, инверторах и мощности площадки.
Мощность в реальном времени: Проверка мгновенной выходной мощности переменного тока.
Поддержка нескольких транспортов: Запуск локально через Stdio или удаленно через SSE.
Мультиарендность (BYOC): Поддержка использования собственных учетных данных (Bring Your Own Credentials) в общей среде.

Установка

Через Gemini CLI (рекомендуется)

Чтобы установить расширение напрямую из GitHub:

gemini extensions add https://github.com/your-org/meteocontrol-mcp

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

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

git clone https://github.com/your-org/meteocontrol-mcp.git
cd meteocontrol-mcp

Установите зависимости и выполните сборку:
```
npm install
npm run build
```

Использование

После установки вы можете спрашивать Gemini о своих солнечных системах:

"List my solar systems." (Список моих солнечных систем)
"What is the energy production for system [systemKey] for the last 24 hours?" (Какова выработка энергии для системы [systemKey] за последние 24 часа?)
"Show me the technical details for INV1 in system [systemKey]." (Покажи мне технические детали для INV1 в системе [systemKey].)

Использование в мультиарендном режиме (BYOC)

Если вы используете общий MCP-сервер, вы можете предоставить свои собственные учетные данные непосредственно в запросах или настроить их локально. Инструменты принимают необязательные аргументы apiKey, user и password.

Предварительно настроенные команды

/health [systemKey]: Выполнение комплексной проверки работоспособности площадки.
/yield [systemKey]: Получение и обобщение данных о выработке энергии.

Развертывание и хостинг

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

1. Локальный режим (Stdio)

Это режим по умолчанию, используемый Gemini CLI.

Команда: node dist/index.js
Настройка: Определяется в gemini-extension.json с использованием command и args.

2. Удаленный режим (SSE)

Используйте этот режим для размещения MCP-сервера на центральном сервере для нескольких пользователей.

Безопасность: Генерация токена доступа

Удаленный режим требует обязательного MCP_SERVER_TOKEN для безопасности. Вы можете сгенерировать безопасный токен с помощью:

openssl rand -base64 32

Настройка сервера

Переменные окружения:
- MCP_TRANSPORT=sse
- MCP_SERVER_TOKEN=ваш_сгенерированный_токен (обязательно)
- PORT=3000 (необязательно, по умолчанию 3000)

Команда запуска:

MCP_TRANSPORT=sse MCP_SERVER_TOKEN=your_token node dist/index.js

3. Режим Docker

Вы можете запустить сервер как контейнер для простого развертывания.

Для режима Stdio (использование CLI):

docker run -i --rm \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

Для режима SSE (хостинг):

docker run -d \
  -p 3000:3000 \
  -e MCP_TRANSPORT=sse \
  -e MCP_SERVER_TOKEN=your_token \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

Настройка клиента (для SSE)

В вашем локальном файле .gemini/settings.json добавьте url и заголовок Authorization:

{
  "mcpServers": {
    "meteocontrol": {
      "url": "https://your-mcp-server.com/sse",
      "headers": {
        "Authorization": "Bearer your_generated_token"
      }
    }
  }
}

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

Для взаимодействия сервера с MeteoControl требуются следующие переменные окружения (если учетные данные не предоставляются в каждом запросе):

METEOCONTROL_API_KEY: Ваш API-ключ VCOM.
METEOCONTROL_USER: Ваше имя пользователя VCOM (email).
METEOCONTROL_PASSWORD: Ваш пароль VCOM.

Лицензия

Apache License 2.0

MeteoControl MCP Server