关于 zeroclaw-mcp
zeroclaw-mcp 是一个本地 MCP 服务,用于配置和管理经授权的 ZeroClaw 安装,面向使用 Codex、Claude Code 或其他 MCP 客户端的用户。它通过客户端权限审核管理指定连接,凭据保存在本地。
主要功能
- 01安装并注册 MCP 插件
- 02设置命名的 ZeroClaw 连接
- 03管理授权的 ZeroClaw 安装
- 04保留配置备份与既有版本
- 05通过客户端审核精确权限
适用场景
- 01在 Codex 或 Claude Code 中安装插件
- 02从其他 MCP 客户端连接本地管理服务
- 03审核连接设置及工具权限
- 04更新插件并保留配置备份
MCP 相关
该项目本身是本地 stdio MCP 服务,可通过 npx 启动并配置到兼容客户端。安装插件不会自动授权管理机器;权限须由客户端审核。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
ZeroClaw MCP
你的硬件。你的记忆。你的模型,由你选择。
为你的 Agent 安装插件:
npx -y @zeroclaw-labs/[email protected] install --codex
# Or:
npx -y @zeroclaw-labs/[email protected] install --claude
选择这两个标志即可为两个客户端都安装。安装程序会验证软件包,在 npm 缓存之外保留一个持久副本,备份受影响的客户端设置,并使用客户端的插件命令。它会检查捆绑的 MCP,而不会联系目标。重启客户端并询问:设置 ZeroClaw。将其命名为 Home Lab,并使用我保存的实验室连接。 在 Claude Code 中,你也可以运行 /zeroclaw:setup。
安装程序需要 Node.js 22 或更高版本,以及所选客户端的 CLI。支持的控制器包括 Apple Silicon macOS 和使用 glibc 2.39 或更高版本的 ARM64/x86-64 GNU Linux。原生插件启动无需 Node、Python、编译器或额外下载。目标操作仍需要现有的 OpenSSH、受支持的 GitHub CLI 和已准备好的 Linux 账户。
对于其他 MCP 客户端,请配置 stdio 服务,命令为 npx,参数为 ["-y", "@zeroclaw-labs/[email protected]", "mcp"]。服务在本地运行;软件包下载 URL 并不是托管的 MCP 端点。
客户端市场
也可以不使用上述安装程序,直接在客户端中添加公共市场:
# Codex
codex plugin marketplace add zeroclaw-labs/zeroclaw-mcp-distribution
codex plugin add zeroclaw@zeroclaw-labs
# Claude Code
claude plugin marketplace add zeroclaw-labs/zeroclaw-mcp-distribution
claude plugin install zeroclaw@zeroclaw-labs
每个客户端选择一种安装方式。如果你已使用 install --codex 或 install --claude 安装,请继续使用该命令进行更新;该命令负责管理此客户端的本地市场。
ZeroClaw 和其他框架
对于接受通用 MCP JSON 配置的客户端,请添加:
{
"mcpServers": {
"zeroclaw": {
"command": "npx",
"args": ["-y", "@zeroclaw-labs/[email protected]", "mcp"]
}
}
}
对于 ZeroClaw,请将服务和捆绑项合并到客户端配置中,并保留现有条目:
[[mcp.servers]]
name = "zeroclaw_manager"
command = "npx"
args = ["-y", "@zeroclaw-labs/[email protected]", "mcp"]
tool_timeout_secs = 600
[mcp_bundles.zeroclaw_manager]
servers = ["zeroclaw_manager"]
在所选客户端 Agent 现有的 mcp_bundles 列表中加入 zeroclaw_manager。其工具权限仍然适用。客户端与被管理的安装是相互独立的。如果客户端没有 MCP 权限审核表单,请在终端运行 npx -y @zeroclaw-labs/[email protected] setup,以审核连接和权限。终端设置也可以注册现有的 ZeroClaw 客户端。
如果客户端的启动时限较短,请先运行一次 npx -y @zeroclaw-labs/[email protected] --version。获取完成后,为启动预留 20 秒,为管理工具预留 600 秒。如果客户端未继承 shell 的 PATH,请使用 npx 的绝对路径。
权限和更新
安装插件并不意味着获准管理计算机。设置时会在对话中提出一个命名连接,随后客户端会要求你审核具体权限。凭据保存在本地私有文件中。插件没有钩子,也不会自动批准工具。
发布较新版本后,再次运行安装命令即可更新。安装程序会保留较早的软件包版本和配置备份。如果现有市场或 MCP 注册项的来源冲突,安装程序会提示审核,而不会静默替换。现有管理器状态仍保存在 ~/.zeroclaw-manager/ 下,已验证的原生运行时仍保存在 ~/.local/lib/zeroclaw-mcp/ 下。
发行说明和直接下载可在发行仓库中获取。此软件包复用已验证的 MCP 运行时 0.1.0-alpha.7 和原始原生启动器;软件包/插件自身的版本为 0.1.0-alpha.4。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。