1Panel MCP Server

Сервер, реализующий протокол MCP (Model Context Protocol) для панели управления 1Panel. Позволяет AI-ассистентам (например, Cursor, Windsurf) напрямую взаимодействовать с 1Panel: получать информацию о системе, управлять сайтами, сертификатами, базами данных и приложениями.

Установка

Требования

• Go 1.23.0 или выше
• Установленная и работающая 1Panel

Сборка из исходников

git clone https://github.com/1Panel-dev/mcp-1panel.git
cd mcp-1panel
make build

После сборки переместите ./build/mcp-1panel в директорию, доступную через PATH.

Установка через go install

go install github.com/1Panel-dev/mcp-1panel@latest

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

Сервер поддерживает два режима транспорта: stdio (по умолчанию) и SSE.

Режим stdio

Настройте MCP-клиент (Cursor, Windsurf) следующим образом:

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "<ваш токен доступа к 1Panel>",
        "PANEL_HOST": "http://localhost:8080"
      }
    }
  }
}

Режим SSE

Сначала запустите сервер MCP с SSE-транспортом:

mcp-1panel -host http://localhost:8080 -token <ваш токен> -transport sse -addr "http://localhost:8000"

Затем настройте клиент:

{
  "mcpServers": {
    "mcp-1panel": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Параметры командной строки

Переменные окружения

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

• PANEL_HOST — адрес доступа к 1Panel
• PANEL_ACCESS_TOKEN — токен доступа к 1Panel

Доступные инструменты

Сервер предоставляет следующие инструменты для взаимодействия с 1Panel:

Примечания

• Убедитесь, что токен доступа имеет необходимые права для выполнения операций.
• Для работы с SSE-режимом убедитесь, что порт 8000 (или другой указанный) доступен и не занят.
• При использовании stdio-режима сервер запускается как дочерний процесс MCP-клиента.