gromy/ms-mcp repository overview

⁠ms-mcp

Mail Admin MCP — HTTP-сервис Model Context Protocol для Р7-Почтовый сервер.

Предоставляет MCP endpoint /mcp для интеграции AI-клиентов с админ-панелью почтового сервера. При старте генерирует конфигурацию из переменных окружения (Jinja2), регистрирует экземпляр в кластере и подключается к PostgreSQL.

• Базовый образ: Debian Bookworm
• HTTP: порт 5110
• MCP endpoint: /mcp
• Health check: GET /health
• Конфигурация: /opt/r7-mailserver/mcpserver/appsettings.json

⁠Быстрый старт

docker run -d \
  --name ms-mcp \
  --hostname ms-mcp \
  -p 5110:5110 \
  -e MS_MCP_DB_HOST=ms-psql \
  -e MS_MCP_DB_PWD=secret \
  -v ms-mcp-logs:/var/log/r7-office/Mail.Admin.Mcp.Host \
  gromy/ms-mcp:latest

Минимально необходимо указать параметры подключения к PostgreSQL.

docker run --env-file .env --name ms-mcp \
  -p 5110:5110 \
  -v ms-mcp-logs:/var/log/r7-office/Mail.Admin.Mcp.Host \
  gromy/ms-mcp:latest

⁠Порты

Порт задаётся переменной MS_MCP_HTTP_PORT (по умолчанию 5110).

⁠Тома

Рекомендуется монтировать том или bind-mount для сохранения логов между перезапусками.

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

⁠PostgreSQL

⁠Экземпляр службы

⁠HTTP-сервер

Адрес сервиса в appsettings.json формируется как http://<MS_MCP_HTTP_LISTEN>:<MS_MCP_HTTP_PORT>.

⁠Логирование

⁠MCP-клиент

{
  "mcpServers": {
    "r7-mail-admin": {
      "url": "http://127.0.0.1:5110/mcp",
      "headers": {
        "X-Mail-Login": "your-login",
        "X-Mail-Password": "your-password"
      }
    }
  }
}

⁠Пример Docker Compose

services:
  ms-mcp:
    image: gromy/ms-mcp:latest
    hostname: ms-mcp
    env_file: .env
    ports:
      - "5110:5110"
    volumes:
      - mcp-logs:/var/log/r7-office/Mail.Admin.Mcp.Host
    depends_on:
      ms-psql:
        condition: service_healthy

volumes:
  mcp-logs:

⁠Связанные образы

⁠Ссылки

• GitLab — ms-mcp⁠
• Документация переменных окружения: README.md в репозитории