Skip to main content
Glama
AItomation MCP relay

AItomation MCP relay

AItomation MCP relay

インバウンドAIコネクタ向けのユーザー管理型HTTPSエッジ。他のアプリは、あなたが所有するアドレスでこのプロセスを呼び出します。お使いのコンピュータ上のアプリは、後でこのプロセスとペアリングしてツールを実行します。このプロセス自体がツールを実行することはありません。

このリポジトリはコネクタプロセスのみです。デスクトップアプリでも、Team Space チームサーバーでもありません。

このドアは当社ではホストしません。管理下のサーバーに配置してください。デスクトップアプリのアップデートでこのプロセスが更新されることはありません。デスクトップの v* タグがこのイメージを公開することもありません。

1プロセスにつき1プロジェクト

1つのリレーは、1つのデバイスと1つのプロジェクトにのみ通信します。

  • パブリックHTTPSドアが必要な3つのプロジェクトには、3つのプロセスが必要です。

  • 1つの名前でのパスプレフィックス(/project-a/mcp)は拒否されます。

  • 同じマシン上のTeam Spaceサーバーは4つ目のプロセスです。同じマシンは問題ありません。同じプロセスは不可です。

Related MCP server: VBridge

クイックスタート(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)でも、1行のテキスト AItomation MCP relay が返ります。

POST /mcp は、サインイントークンなしでは401と、well-known JSONを指す WWW-Authenticate ヘッダーを返します。アプリをペアリングしてOAuthを完了すると、そのPOSTはアプリに転送されます。ツールがこのプロセス上で実行されることはありません。ペアリングには /pair/hello、/pair/next、/pair/reply、/pair/unavailable を使用します。

公式イメージはマルチアーキテクチャ(linux/amd64 と linux/arm64)です。本番環境ではバージョンタグを固定することをお勧めします。

パブリックホスト上のパブリック証明書

このコネクタを呼び出すクラウドホスト(ChatGPT、Claude、Grok、Gemini Enterprise)には、パブリック認証局からの証明書が必要です。パブリックホストで自己署名証明書を使用しないでください。このプロセスの前にパブリック証明書を持つリバースプロキシを配置するか、その認証局から取得済みの MCP_RELAY_TLS_CERT_FILE と MCP_RELAY_TLS_KEY_FILE を渡してください。

環境

名前

デフォルト

備考

MCP_RELAY_HOST

127.0.0.1

Dockerは 0.0.0.0 を設定します。

MCP_RELAY_PORT

8790

予約ポートは拒否されます。

MCP_RELAY_DATA_DIR

./data

サービス管理下では絶対パスを使用してください。

MCP_RELAY_PAIR_SECRET

未設定

ペアシークレットはenvに保持し、argvには決して入れないでください。

MCP_RELAY_PUBLIC_URL

未設定

パブリックhttpsオリジン(オプションの /mcp)。well-known resource で使用されます。

MCP_RELAY_STATIC_HEADER_HASH

未設定

オプション。ペアリングしたプロジェクトのClaudeリクエストヘッダーキーのSHA-256 hex。

MCP_RELAY_TLS_CERT_FILE

未設定

オプション。パブリックホスト用のパブリックCA。

MCP_RELAY_TLS_KEY_FILE

未設定

証明書ファイルと対で使用します。

このプロセスはTeam Spaceの環境名を読み取りません。

OAuthはポート8790に留まります。認可URLは /authorize です。トークンURLは /token です。スコープに offline_access を含めてください。Gemini Enterpriseは、初回起動時に発行される機密クライアントID(シークレットはデータディレクトリの下に一度だけ書き込まれます)とリダイレクト https://vertexaisearch.cloud.google.com/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 を実行してください。

ステップバイステップのサービスユニット、3プロジェクト構成、HTTPSプロキシスニペット: docs/SELF-HOST.md。

停止

SIGTERMまたはSIGINTは新しい作業を停止し、進行中の POST /mcp 転送が完了するのを待ってから終了します。プロセスはPOSTの途中で自分自身を終了させません。

情報源

日々の編集はAItomationモノレポの packages/mcp-relay にあり、顧客向けにここに公開されています。公式GHCR書き込みはこのリポジトリの publish-image ワークフローです。デスクトップカットはこの画像を公開しません。

ライセンス

MIT - 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