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，并带有一个指向 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。

环境

此进程不读取 Team Space 的环境变量。

OAuth 保持使用端口 8790。授权 URL 为 /authorize。令牌 URL 为 /token。在请求的 scope 中要包含 offline_access。Gemini Enterprise 使用首次启动时生成的机密客户端 ID（secret 只在数据目录下写入一次），并重定向至 https://vertexaisearch.cloud.google.com/oauth-redirect。Well-known JSON 位于 /.well-known/oauth-protected-resource 和 /.well-known/oauth-protected-resource/mcp。这些路径上没有 HTML 兜底页面。

备选方案（clone + 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 monorepo 的 packages/mcp-relay 中，并发布于此供客户使用。官方 GHCR 写入目录来自本仓库的 publish-image 工作流。桌面版发布不会发布此镜像。

许可证

MIT — 请参见 LICENSE。