hands mcp

hands 是 Hawa Code 的远程执行机制：把工具放入代码所在的沙箱中运行，将 模型推理流量 与 工具执行请求 完全解耦。模型的请求流量无需进入沙箱即可完成工具调用，因此在保留沙箱隔离的同时，能够完整保留工具能力。

工具通过 MCP 协议对外提供。你既可以直接使用 Hawa Code 内置的 MCP，也可以接入 Hawa Code 单独提供的 MCP 工具。下文介绍 hands MCP 的使用方式。

---

启动 hands mcp 服务

在沙箱（或任意远程机器）中执行以下命令启动 hands 服务，启动成功后会输出可供客户端连接的 URL：

npm i @dahawa/hawa-hands

hawa-hands

---

客户端配置

在 Hawa Code 或其他支持 MCP 的客户端的 .mcp.json 中添加：

{
  "mcpServers": {
    "hands": {
      "type": "http",
      "url": "https://<your-codespaces-host>-3000.app.github.dev/mcp"
    }
  }
}

实际 URL 以 hands 启动时输出的为准；若部署在 Codespaces 上，URL 在实例重启后可能变化，需要同步更新此处配置。

---

提供的 MCP 工具

工具	说明
Bash	在远程机器执行 shell 命令，支持后台运行与超时控制
Read	读取远程文件内容，支持 offset / limit 分段读取
Edit	对远程文件做精确字符串替换
Write	在远程文件系统写入或覆盖文件
Glob	按 glob 模式快速匹配文件路径
Grep	基于 ripgrep 的正则搜索，支持文件类型与上下文过滤
NotebookEdit	编辑远程 Jupyter Notebook 的单元格
TaskOutput	拉取后台任务（shell / agent）的实时输出
TaskStop	终止指定的后台任务

---