customclaw-mcp

Устанавливайте, а не переписывайте. MCP-сервер для реестра CustomClaw — 37 проверенных однофайловых утилит для кода LLM и агентов (ограничители частоты запросов, учитывающие Retry-After, исправление JSON, кэши ответов, повторные попытки с экспоненциальной задержкой, счетчики токенов, очистители PII). Ваш агент получает четыре встроенных вызова инструментов вместо 120 строк правдоподобно выглядящего нового кода.

📖 Предыстория: Проблема «амнезии утилит» — почему ваш агент по написанию кода переписывал один и тот же ограничитель частоты запросов 47 раз.

Установка за 30 секунд

npx -y customclaw-mcp

Вставьте эту команду в конфигурацию вашего MCP-клиента (примеры ниже), и всё готово. Бесплатные инструменты устанавливаются без авторизации.

Что это делает

Подключает каталог CustomClaw (37 утилит, 32 бесплатные) к любому хосту Model Context Protocol — 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.

Streamable HTTP (smithery, ChatGPT и т.д.)

Используйте размещенную конечную точку: https://customclaw.company/mcp. Зарегистрировано на smithery как onlythebestswfl/customclaw.

Примеры промптов

После подключения:

• "Add a rate limiter that respects Retry-After." → search_utilities → install_utility rate-limit-handler

• "I need to parse broken JSON from Claude output." → json-repair

• "What do you have for caching LLM responses?" → search_utilities → краткая таблица результатов

• "Install token-optimiser into ./src/lib." → прямой вызов install_utility

• "Scan this project's prompts for injection — is there a tool?" → injection-scanner

Краткий справочник: Задача → слаг

Полный список доступен через list_utilities или на customclaw.company/api/catalog.

Платные утилиты

Для платных утилит передайте session_id из Stripe checkout, полученный в письме с чеком, в качестве аргумента 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.