AI导哈

AI编码代理移动控制服务

Punchdown MCP服务器是一个为AI编码代理提供移动控制平面的服务，支持通过手机接收审批请求、输入提示和状态更新，兼容Claude Code、Gemini CLI和OpenAI Codex。

  • by Lepercon-Studios
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Lepercon-Studios/punchdown-mcp-server

使用说明

@lepercon工作室/冲压式mcp服务器

MCP服务器 插孔板 --用于AI编码代理的移动控制平面。

当您的AI编码代理需要批准、输入或想要共享状态更新时，在您的手机上获取推送通知。使用 克劳德代码, Gemini CLI，以及 OpenAI Codex.

安装

npm install -g @lepercon-studios/punchdown-mcp-server

配置您的代理

自动检测所有已安装的代理

punchdown setup

或单独配置

克劳德代码：

claude mcp add punchdown -- npx @lepercon-studios/punchdown-mcp-server

Gemini CLI：

gemini mcp add punchdown -- npx @lepercon-studios/punchdown-mcp-server

Codex CLI：

codex mcp add punchdown -- npx @lepercon-studios/punchdown-mcp-server

配对您的设备

punchdown pair

使用Punchdown移动应用程序扫描二维码。配对使用Ed25519密钥对交换，不需要帐户或密码。

MCP工具

工具 行为 回报
request_approval 阻止，直到用户批准/拒绝 { decision, user_message }
request_input 阻止，直到用户提供输入 { response }
notify_status 即发即弃 { delivered }
set_task_context 即发即弃 { updated }

request_approval

向用户的手机发送批准请求，其中包含行动摘要、详细信息和风险级别。

request_input

向用户提出一个问题，并提供可选的建议答案。直到回答。

notify_status

向移动仪表板发送状态更新（里程碑、进度、错误、完成）。

set_task_context

使用当前任务标题、描述和涉及的文件更新移动仪表板。

克劳德代码挂钩

Punchdown可以与Claude Code集成 钉钩系统 在执行前后拦截工具调用。这使您可以通过Punchdown的移动应用程序自动发送审批请求。

PreToolUse挂钩

添加a PreToolUse 在任何工具运行之前，挂钩都需要移动批准。如果用户拒绝请求，钩子将以代码2退出以阻止该工具：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "punchdown approve --tool $CLAUDE_TOOL_NAME",
            "timeout": 30000
          }
        ]
      }
    ]
  }
}

PostTool使用挂钩

添加a PostToolUse 钩子在每个工具完成后发送状态通知：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "punchdown notify --tool $CLAUDE_TOOL_NAME --status completed",
            "timeout": 5000
          }
        ]
      }
    ]
  }
}

选择性匹配

使用 matcher 字段将钩子限制为特定工具。例如，只需要批准文件写入和bash命令：

{
  "matcher": "Write|Bash|Edit",
  "hooks": [{ "type": "command", "command": "punchdown approve --tool $CLAUDE_TOOL_NAME", "timeout": 30000 }]
}

看 examples/claude-hooks.json 以获得完整的示例配置。

安全

  • 端到端加密：所有工具调用内容在离开机器之前都用NaCl盒加密
  • 没有帐户：通过Ed25519键对交换（二维码）进行设备配对
  • 零知识接力：云中继只路由不透明的密文
  • 运输安全：所有连接都使用WSS（TLS 1.3）

发展

git clone https://github.com/Lepercon-Studios/punchdown-mcp-server.git
cd punchdown-mcp-server
npm install
npm run build
npm run dev  # watch mode
npm test

许可证

麻省理工学院

相关 MCP