customclaw-mcp

Instala, no regeneres. Servidor MCP para el registro de CustomClaw: 37 utilidades de archivo único verificadas para código de LLM y agentes (limitadores de tasa que respetan Retry-After, reparación de JSON, cachés de respuesta, reintentos con retroceso, contadores de tokens, depuradores de PII). Tu agente obtiene cuatro llamadas a herramientas nativas en lugar de 120 líneas de código nuevo que parece plausible.

📖 Antecedentes: El problema de la amnesia de utilidades — por qué tu agente de codificación reescribió el mismo limitador de tasa 47 veces.

Instalación en 30 segundos

npx -y customclaw-mcp

Copia ese comando en la configuración de tu cliente MCP (fragmentos a continuación) y listo. Las herramientas gratuitas se instalan sin autenticación.

Qué hace

Conecta el catálogo de CustomClaw (37 utilidades, 32 gratuitas) a cualquier host del Protocolo de Contexto de Modelo (MCP) — Claude Desktop, Claude Code, Cursor, Windsurf, cualquier cosa que hable MCP — como cuatro herramientas:

Instalación (por cliente)

Claude Desktop

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

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

Reinicia Claude Desktop. Las herramientas aparecerán en el selector de herramientas.

Claude Code

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

Cursor / Windsurf / cualquier host MCP stdio

Apunta el host a npx -y customclaw-mcp.

HTTP transmitible (smithery, ChatGPT, etc.)

Usa el endpoint alojado: https://customclaw.company/mcp. Registrado en smithery como onlythebestswfl/customclaw.

Ejemplos de prompts

Una vez conectado:

• "Añade un limitador de tasa que respete Retry-After." → search_utilities → install_utility rate-limit-handler

• "Necesito analizar JSON roto de la salida de Claude." → json-repair

• "¿Qué tienes para el almacenamiento en caché de respuestas de LLM?" → search_utilities → tabla de resultados cortos

• "Instala token-optimiser en ./src/lib." → install_utility directo

• "Escanea los prompts de este proyecto en busca de inyecciones —¿hay alguna herramienta?" → injection-scanner

Referencia rápida de Tarea → slug

Lista completa mediante list_utilities o customclaw.company/api/catalog.

Utilidades de pago

Para las utilidades de pago, pasa el session_id de pago de Stripe de tu correo electrónico de recibo como el argumento session_id para install_utility. Sin él, la herramienta devuelve un 401 útil.

Entorno

• CUSTOMCLAW_BASE — anulación de la URL base del registro (predeterminado https://customclaw.company). Útil para entornos de prueba o espejos autohospedados.

Cómo funciona

• Servidor MCP stdio de Node.js. Dependencia: @modelcontextprotocol/sdk.

• Catálogo obtenido de GET /api/catalog; caché de 5 min por proceso.

• Cargas útiles de GET /api/cli?slug=<slug>[&session_id=<cs_...>] — el mismo endpoint que usa el customclaw-cli oficial.

• install_utility se niega a escribir fuera de target_dir (protección contra recorrido de rutas).

Enlaces

• Registro: customclaw.company

• Compañero CLI: customclaw-cli

• Fuente: github.com/onlythebestswfl-ops/customclaw-mcp

Licencia

MIT.