AItomation MCP relay

Benutzergehostete HTTPS-Schnittstelle für eingehende KI-Konnektoren. Andere Apps rufen diesen Prozess über eine Adresse auf, die Ihnen gehört. Die App auf Ihrem Computer koppelt sich später mit ihm und führt die Tools aus. Dieser Prozess führt selbst nie Tools aus.

Dieses Repository ist nur der Konnektor-Prozess. Es ist weder die Desktop-App noch der Team-Space-Teamserver.

Wir hosten diese Tür nicht für Sie. Platzieren Sie sie auf einem Server, den Sie kontrollieren. Ein Desktop-App-Update aktualisiert diesen Prozess nicht. Ein Desktop-v*-Tag veröffentlicht dieses Image nicht.

Ein Prozess, ein Projekt

Ein Relay spricht mit einem Gerät und einem Projekt.

• Drei Projekte, die eine öffentliche HTTPS-Tür benötigen, brauchen drei Prozesse.

• Pfadpräfixe auf einem Namen (/project-a/mcp) werden abgelehnt.

• Der Team-Space-Server auf derselben Maschine ist ein vierter Prozess. Dieselbe Maschine ist in Ordnung. Derselbe Prozess nicht.

Related MCP server: Obsidian MCP Server

Schnellstart (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

Standard-Listenport ist 8790. Verwenden Sie nicht 8787, 8788 oder 8789.

GET / und GET /health antworten mit 200. Ein Browser zeigt eine kurze Statusseite. curl und eine spätere Pair-Sonde (Accept: text/plain) erhalten weiterhin den einzeiligen Text AItomation MCP relay.

POST /mcp ohne Anmeldetoken gibt 401 plus einen WWW-Authenticate-Header zurück, der auf das bekannte JSON verweist. Nachdem Sie die App gekoppelt und OAuth abgeschlossen haben, wird dieser POST an die App weitergeleitet. Tools laufen nie auf diesem Prozess. Das Pairing verwendet /pair/hello, /pair/next, /pair/reply und /pair/unavailable.

Offizielle Images sind Multi-Arch (linux/amd64 und linux/arm64). Bevorzugen Sie in Produktion das Pinnen einer Versions-Tag.

Öffentliches Zertifikat auf einem öffentlichen Host

Cloud-Hosts, die diesen Konnektor aufrufen (ChatGPT, Claude, Grok, Gemini Enterprise), benötigen ein Zertifikat von einer öffentlichen Zertifizierungsstelle. Verwenden Sie kein selbst erstelltes Zertifikat auf einem öffentlichen Host. Platzieren Sie einen Reverse-Proxy mit einem öffentlichen Zertifikat vor diesem Prozess oder übergeben Sie MCP_RELAY_TLS_CERT_FILE und MCP_RELAY_TLS_KEY_FILE, die bereits von dieser Zertifizierungsstelle stammen.

Umgebung

Dieser Prozess liest keine Team-Space-Umgebungsnamen.

OAuth bleibt auf Port 8790. Autorisierungs-URL ist /authorize. Token-URL ist /token. Fügen Sie offline_access in die Scopes ein. Gemini Enterprise verwendet die vertrauliche Client-ID, die beim ersten Start geprägt wird (Secret wird einmal unter dem Datenverzeichnis geschrieben) und die Weiterleitung https://vertexaisearch.cloud.google.com/oauth-redirect. Bekanntes JSON befindet sich unter /.well-known/oauth-protected-resource und /.well-known/oauth-protected-resource/mcp. Es gibt kein HTML-Catch-all auf diesen Pfaden.

Alternative (Klon + npm)

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

npm start ist für die Entwicklung. Für einen echten Dienst bauen Sie einmal (npm run build) und führen node dist/server.js unter einem Dienstmanager aus.

Schritt-für-Schritt-Diensteinheit, Drei-Projekt-Compose und HTTPS-Proxy-Ausschnitte: docs/SELF-HOST.md.

Stopp

SIGTERM oder SIGINT stoppt neue Arbeit, wartet auf laufende POST /mcp-Weiterleitungen und beendet dann. Der Prozess beendet sich nicht mitten im POST.

Quelle der Wahrheit

Tägliche Änderungen leben im AItomation-Monorepo packages/mcp-relay und werden hier für Kunden veröffentlicht. Offizieller GHCR-Write ist der publish-image-Workflow dieses Repos. Der Desktop-Schnitt veröffentlicht dieses Image nicht.

Lizenz

MIT – siehe LICENSE.