mcpField
Z
zeroclaw-mcp

zeroclaw-mcp

本地服务
github.com/zeroclaw-labsAI 与智能体05 天前更新

关于 zeroclaw-mcp

zeroclaw-mcp 是一个本地 MCP 服务,用于配置和管理经授权的 ZeroClaw 安装,面向使用 Codex、Claude Code 或其他 MCP 客户端的用户。它通过客户端权限审核管理指定连接,凭据保存在本地。

主要功能

  1. 01安装并注册 MCP 插件
  2. 02设置命名的 ZeroClaw 连接
  3. 03管理授权的 ZeroClaw 安装
  4. 04保留配置备份与既有版本
  5. 05通过客户端审核精确权限

适用场景

  1. 01在 Codex 或 Claude Code 中安装插件
  2. 02从其他 MCP 客户端连接本地管理服务
  3. 03审核连接设置及工具权限
  4. 04更新插件并保留配置备份

MCP 相关

该项目本身是本地 stdio MCP 服务,可通过 npx 启动并配置到兼容客户端。安装插件不会自动授权管理机器;权限须由客户端审核。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"zeroclaw-labs-zeroclaw": {
"command": "npx",
"args": [
"-y",
"@zeroclaw-labs/zeroclaw-mcp"
]
}
}
}
启动命令npx -y @zeroclaw-labs/zeroclaw-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@zeroclaw-labs/zeroclaw-mcp0.1.0-alpha.4

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

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。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。