🍏 Remote MCP Hub macOS 安装与连接指南

面向需要为 AI 模型（Notion AI、Claude、Cursor 等）提供对 Mac 文件和命令行的安全远程访问的 macOS 客户和用户指南。

📋 系统要求

• macOS（支持 Apple Silicon M1/M2/M3/M4 和 Intel 处理器）

• 已安装 Node.js（18 或更高版本）➔ 下载 Node.js (LTS) 或通过命令 brew install node 安装

Related MCP server: Codex 2.0 MCP Gateway

⚡ 4 步快速安装

第 1 步：下载项目

克隆仓库或从 GitHub 下载 ZIP 压缩包到任意方便的文件目录：

git clone https://github.com/etern1ty-crypto/remote-mcp-hub.git
cd remote-mcp-hub

第 2 步：运行安装脚本 install.sh

在项目文件夹中打开 终端（Terminal） 应用并执行：

chmod +x install.sh start.sh && ./install.sh

该脚本将自动完成以下操作：

1. 检查系统中是否安装了 Node.js。

2. 安装所有必要的库（npm install）。

3. 为您的 Mac 架构（Apple Silicon 或 Intel）下载官方的 Cloudflare Tunnel 原生模块（cloudflared）。

4. 将可用的 VPN 服务器订阅链接直接复制到您的 macOS 剪贴板。

第 3 步：在 Mac 上配置 VPN（耗时 30 秒）

为了让 Cloudflare Tunnel 和 AI 服务在俄罗斯/独联体国家稳定运行，建议使用免费客户端 Hiddify：

1. 安装 Hiddify：

   • 从 Mac App Store 或官方 GitHub 下载。

2. 粘贴订阅：

   • 链接已复制到剪贴板： https://github.com/AvenCores/goida-vpn-configs/raw/refs/heads/main/githubmirror/6.txt

   • 在 Hiddify 中点击 “+” 按钮（新配置文件）➔ “从剪贴板添加”（或 Cmd + V）。

   • 点击 “更新配置” 以加载服务器。

3. 检查延迟并连接：

   • 启动 Ping 检查（延迟测试）。

   • 选择任意可用服务器（绿色 ping）并点击大的圆形 连接 按钮。

第 4 步：启动 Remote MCP Hub 服务器

在终端中执行：

./start.sh

1. 浏览器将自动打开管理 Web 面板：http://localhost:3800。

2. 在界面中点击 “启动隧道” 按钮。

3. 状态将变为 “🟢 在线”，随后会显示如下格式的个人专属地址： https://<имя-туннеля>.trycloudflare.com/sse

4. 点击 “复制” 按钮，分别复制 MCP server URL 和 Bearer Token 旁边的内容。

🔌 连接 Notion AI

1. 在 Notion 设置中，进入 Custom MCP Server 部分。

2. 填写以下字段：

   • **MCP server URL：**粘贴已复制的地址（https://...trycloudflare.com/sse）

   • **Name：**填写任意名称（例如 MacBook-Pro）

   • **Authentication：**选择 Bearer 类型

   • **Token：**粘贴您的密钥（以 mcp_... 开头）

3. 点击 “Connect” / “Save”。

🧪 验证运行

向 Notion AI 发送一条测试消息：

Привет! Проверь подключение к моему Mac: выполни в терминале команду "echo MCP на Mac подключен успешно! && uname -a && ls -la" и выведи результат.

在浏览器窗口中，打开页面 http://localhost:3800 并切换到 “AI 调用日志” 标签页，您将实时看到请求的执行情况。

🔒 安全性

• AI 与您的电脑之间传输的所有数据均受端到端加密保护（HTTPS / Cloudflare Tunnel）。

• 访问权限由机密 Bearer 令牌严格限制。

• 您可以随时关闭隧道或更换访问密钥。