开源MCP工具

快速开始

1. 装（推荐 Homebrew · Mac 最快路径）

brew tap LinekForge/forge-hub https://github.com/LinekForge/forge-hub
brew install forge-hub
forge-hub install   # 部署脚本在 Homebrew sandbox 里跑不了，装完手动跑一次

<details> <summary><strong>或从源码装</strong>（想 customize / 非 Mac / CI 场景）</summary>

git clone https://github.com/LinekForge/forge-hub.git ~/forge-hub
cd ~/forge-hub && bun cli.ts install

</details>

forge-hub install 部署 hub-server、hub-client、hub-dashboard、launchd plist、MCP 注册。

[!NOTE] Forge Engine 目前是 experimental / manual setup：仓库里已经带源码、MCP server 和 fh engine ... CLI，但 不在 forge-hub install 的默认部署面里。想启用的话，按 forge-engine/README.md 单独注册。

2. 配通道凭证（按你要用的）

详见 配置.md。最简单的是 Telegram：

1. @BotFather 拿 bot_token，写到 ~/.forge-hub/state/telegram/config.json（{"bot_token":"..."}） 2. 先给 bot 发一条消息（会被 allowlist 拒绝，hub log 记下你的 chat_id）：

   tail -f ~/.forge-hub/hub.log | grep -iE "(telegram|inbound|未授权)"
   

   fh hub allow telegram <chat_id> "我"
   fh hub owner telegram <chat_id>
   

3. 启动 Claude Code 接入 hub

claude --dangerously-load-development-channels server:hub

打开你绑的 IM 发消息，终端 Claude Code 收到。Claude 回复自动发回。

[!IMPORTANT] --dangerously-load-development-channels 是 Anthropic Channels 协议的 opt-in flag——详见 Channels Reference。基础 channel 能力最低 Claude Code 版本：2.1.80；远程审批 relay 需要 2.1.81+。

[!IMPORTANT] 远程审批需要配 approval_channels 和审批 owner。Claude 跑 Bash / Write / Edit 等工具时会请求审批，hub-server 根据 approval_channels 把请求推到手机；每个审批通道还必须有显式 owner（fh hub owner <channel> <id>），只有 owner 的 yes/no 回复会生效。没配 approval_channels 时远程审批不生效，工具调用会降级到本地终端弹窗确认。要启用远程审批，编辑 ~/.forge-hub/hub-config.json，用完整本机安全配置起步：

> {
>   "port": 9900,
>   "host": "127.0.0.1",
>   "primary_instance": "",
>   "show_instance_tag": false,
>   "approval_channels": ["telegram"]
> }
> 

把 approval_channels 换成你已配置 owner 的通道。详见 配置.md §审批推送配置。 Dashboard 的审批队列显示的是已经成功登记的 pending 审批；它不是 approval_channels 的替代入口。外部审批通道推送成功后，Dashboard 才会同步看到这条审批并可在本机处理。

[!NOTE] 首次调用 hub_reply / hub_send_file 等 MCP 工具时 Claude Code 会弹审批——属于 CC 默认的 MCP tool approval 行为，不是 forge-hub 的设计。approve 一次，或在 CC 里 /allowed-tools 添加 mcp__hub__hub_reply / mcp__hub__hub_send_file / mcp__hub__hub_send_voice 到全局允许列表，之后就不再弹。

[!TIP] 想用但不想自己装？ 把这个 GitHub 链接发给你的 agent（Claude Code / OpenClaw / Cursor / 任何能读 README + 跑 shell 的），它会照上面的 runbook 装起来——需要你手动操作（扫码 / Touch ID / 授权 Full Disk Access）时会停下让你做。

<details> <summary><strong>启用远程审批</strong></summary>

Claude Code 默认只对少数 tool 弹审批。要让更多 tool call 走远程审批：

cp examples/pretooluse-guard.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/pretooluse-guard.sh

然后 ~/.claude/settings.json 加：

"hooks": {
  "PreToolUse": [
    {
      "hooks": [
        { "type": "command", "command": "bash ~/.claude/hooks/pretooluse-guard.sh" }
      ]
    }
  ]
}

pretooluse-guard.sh 里有详细 pattern 注释，按风险偏好自定义。

Coverage 边界：能 relay 的是 Bash / Write / Edit / MCP tool calls；MCP tool 内部业务 dialog（如 computer-use 选 app）不 relay，只能本地 approve。

</details>

replay/send/ps/security/approval-audit/preset/setup 等

```

</details>