Skip to main content
Glama
AItomation MCP relay

AItomation MCP relay

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: VBridge

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

Name

Standard

Hinweise

MCP_RELAY_HOST

127.0.0.1

Docker setzt 0.0.0.0.

MCP_RELAY_PORT

8790

Reservierte Ports werden abgelehnt.

MCP_RELAY_DATA_DIR

./data

Verwenden Sie einen absoluten Pfad unter einem Dienstmanager.

MCP_RELAY_PAIR_SECRET

nicht gesetzt

Das Pair-Secret bleibt in der Umgebung, nie in argv.

MCP_RELAY_PUBLIC_URL

nicht gesetzt

Öffentlicher HTTPS-Ursprung (optional /mcp). Wird in der bekannten resource verwendet.

MCP_RELAY_STATIC_HEADER_HASH

nicht gesetzt

Optionaler SHA-256-Hex des Claude-Request-Header-Schlüssels für das gekoppelte Projekt.

MCP_RELAY_TLS_CERT_FILE

nicht gesetzt

Optional. Öffentliche Zertifizierungsstelle für einen öffentlichen Host.

MCP_RELAY_TLS_KEY_FILE

nicht gesetzt

Paar mit der Zertifikatsdatei.

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables local programs to push text and images to AI assistants via HTTP and retrieve AI-generated responses, acting as a local data bridge between your code and MCP-capable AI tools.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables authorized remote MCP clients to securely reach local Mac or Windows tools over OAuth, including shell commands, file read/write, background jobs, screenshots, UI control, and clipboard access. It can also expose configured Desktop MCP servers and optional Claude Code task delegation.
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables web-based AI chat clients to securely operate a local computer through an OAuth-gated MCP endpoint, exposing governed tools for files, shell, search, Git, SQLite, browser automation, DevTools, background tasks, localhost services, clipboard, notifications, ports, Postman, and AIObox windows.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Exposes explicitly approved local Windows stdio and loopback HTTP MCP backends through a single OAuth-protected remote HTTPS MCP endpoint, letting a mobile AI client invoke whitelisted tools with namespacing, PKCE-based authorization, and per-tool permissions.
      MIT