AItomation MCP relay

Пользовательский HTTPS-шлюз для входящих AI-коннекторов. Другие приложения обращаются к этому процессу по адресу, который вы контролируете. Приложение на вашем компьютере позже подключается к нему и запускает инструменты. Этот процесс сам никогда не запускает инструменты.

Этот репозиторий — только процесс-коннектор. Это не десктопное приложение и не сервер Team Space.

Мы не размещаем этот шлюз за вас. Разместите его на сервере, которым управляете вы. Обновление десктопного приложения не обновляет этот процесс. Тег v* десктопного приложения не публикует этот образ.

Один процесс — один проект

Один ретранслятор работает с одним устройством и одним проектом.

• Трём проектам, которым нужна публичная HTTPS-дверь, нужны три процесса.

• Префиксы путей на одном имени (/project-a/mcp) отклоняются.

• Сервер Team Space на той же машине — это четвёртый процесс. Та же машина — это нормально. Тот же процесс — нет.

Related MCP server: Obsidian MCP Server

Быстрый старт (Docker)

docker pull ghcr.io/stanislavmandrik621/aitomation-mcp-relay:latest
docker run --rm -p 8790:8790 \
  -e MCP_RELAY_HOST=0.0.0.0 \
  -e MCP_RELAY_PORT=8790 \
  -e MCP_RELAY_DATA_DIR=/data \
  -v mcp-relay-data:/data \
  ghcr.io/stanislavmandrik621/aitomation-mcp-relay:latest

Порт прослушивания по умолчанию — 8790. Не используйте 8787, 8788 или 8789.

GET / и GET /health отвечают кодом 200. Браузер показывает короткую страницу состояния. curl и последующий парный запрос (Accept: text/plain) по-прежнему получают однострочный текст AItomation MCP relay.

POST /mcp без токена входа возвращает 401 и заголовок WWW-Authenticate, указывающий на well-known JSON. После того как вы подключите приложение и завершите OAuth, этот POST пересылается в приложение. Инструменты никогда не запускаются в этом процессе. Для сопряжения используются /pair/hello, /pair/next, /pair/reply и /pair/unavailable.

Официальные образы — multi-arch (linux/amd64 и linux/arm64). В продакшене предпочтительно закреплять версию тега.

Публичный сертификат на публичном хосте

Облачным хостам, которые вызывают этот коннектор (ChatGPT, Claude, Grok, Gemini Enterprise), нужен сертификат от публичного удостоверяющего центра. Не используйте самодельный сертификат на публичном хосте. Разместите перед этим процессом обратный прокси с публичным сертификатом или передайте MCP_RELAY_TLS_CERT_FILE и MCP_RELAY_TLS_KEY_FILE, которые уже получены от этого удостоверяющего центра.

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

Этот процесс не читает имена окружения Team Space.

OAuth остаётся на порту 8790. URL авторизации — /authorize. URL токена — /token. Включите offline_access в области. Gemini Enterprise использует конфиденциальный идентификатор клиента, созданный при первом запуске (секрет записывается один раз в каталог данных), и перенаправление https://vertexaisearch.cloud/oauth-redirect. Well-known JSON находится по адресу /.well-known/oauth-protected-resource и /.well-known/oauth-protected-resource/mcp. На этих путях нет HTML-заглушки.

Альтернатива (клонирование + npm)

git clone https://github.com/stanislavmandrik621/aitomation-mcp-relay.git
cd aitomation-mcp-relay
npm ci
npm start

npm start предназначен для разработки. Для реального сервиса соберите один раз (npm run build) и запустите node dist/server.js под менеджером служб.

Пошаговый модуль службы, compose для трёх проектов и фрагменты HTTPS-прокси: docs/SELF-HOST.md.

Остановка

SIGTERM или SIGINT останавливает приём новых задач, ожидает завершения выполняющихся пересылок POST /mcp, а затем завершает работу. Процесс не завершает себя на середине POST-запроса.

Источник истины

Повседневные правки находятся в монорепозитории AItomation packages/mcp-relay и публикуются здесь для клиентов. Официальная запись GHCR — это рабочий процесс publish-image этого репозитория. Десктопная версия не публикует этот образ.

Лицензия

MIT — см. LICENSE.