customclaw-mcp

安装，而非重新生成。 CustomClaw 注册表的 MCP 服务器 — 包含 37 个经过验证的单文件工具，适用于 LLM 和代理代码（包括遵循 Retry-After 的速率限制器、JSON 修复、响应缓存、带退避的重试、令牌计数器、PII 清理器）。你的代理只需调用四个原生工具，无需编写 120 行看似合理的新代码。

📖 背景：工具健忘症问题 — 为什么你的编码代理已经重写了 47 次相同的速率限制器。

30 秒安装

npx -y customclaw-mcp

将该命令放入你的 MCP 客户端配置中（代码片段见下文），即可完成。免费工具无需身份验证即可安装。

功能介绍

将 CustomClaw 目录（37 个工具，32 个免费）接入任何模型上下文协议 (MCP) 主机 — Claude Desktop、Claude Code、Cursor、Windsurf 或任何支持 MCP 的工具 — 作为四个工具使用：

安装（按客户端）

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "customclaw": {
      "command": "npx",
      "args": ["-y", "customclaw-mcp"]
    }
  }
}

重启 Claude Desktop。工具将出现在工具选择器中。

Claude Code

claude mcp add customclaw -- npx -y customclaw-mcp

Cursor / Windsurf / 任何 stdio MCP 主机

将主机指向 npx -y customclaw-mcp。

可流式传输的 HTTP (smithery, ChatGPT 等)

使用托管端点：https://customclaw.company/mcp。已在 smithery 上注册为 onlythebestswfl/customclaw。

示例提示词

连接后：

• “添加一个遵循 Retry-After 的速率限制器。” → search_utilities → install_utility rate-limit-handler

• “我需要解析 Claude 输出中损坏的 JSON。” → json-repair

• “你们有什么用于缓存 LLM 响应的工具吗？” → search_utilities → 查看简短结果表

• “将 token-optimiser 安装到 ./src/lib 中。” → 直接使用 install_utility

• “扫描此项目的提示词是否存在注入风险 — 有相关工具吗？” → injection-scanner

任务 → 别名快速参考

通过 list_utilities 或 customclaw.company/api/catalog 获取完整列表。

付费工具

对于付费工具，请将收据邮件中的 Stripe 结账 session_id 作为 session_id 参数传递给 install_utility。否则，该工具将返回 401 错误。

环境

• CUSTOMCLAW_BASE — 注册表基础 URL 覆盖（默认为 https://customclaw.company）。适用于暂存环境或自托管镜像。

工作原理

• Node.js stdio MCP 服务器。依赖项：@modelcontextprotocol/sdk。

• 目录从 GET /api/catalog 获取；每个进程缓存 5 分钟。

• 有效载荷来自 GET /api/cli?slug=<slug>[&session_id=<cs_...>] — 与官方 customclaw-cli 使用的端点相同。

• install_utility 拒绝写入 target_dir 之外的路径（路径遍历防护）。

链接

• 注册表：customclaw.company

• CLI 配套工具：customclaw-cli

• 源码：github.com/onlythebestswfl-ops/customclaw-mcp

许可证

MIT。