Codehooks.io

Servidor MCP de Codehooks.io

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona a los agentes de IA operaciones de base de datos, despliegue de código sin servidor y capacidades de gestión de archivos en la plataforma Codehooks.io.

Cuándo usar este MCP en lugar de la CLI directamente

Entorno	¿Tiene terminal?	Enfoque recomendado
Claude Code	Sí	Usa la CLI coho directamente
Cursor	Sí	Usa la CLI coho directamente
Claude Desktop	No	Este servidor MCP

Para agentes de IA con acceso a terminal (Claude Code, Cursor, etc.)

Usar la CLI de Codehooks directamente es más simple y flexible:

1. Instala la CLI: npm install -g codehooks
2. Inicia sesión: coho login
3. Obtén el prompt de IA: coho prompt
4. O consulta la documentación en línea: https://codehooks.io/llms.txt

El agente puede ejecutar comandos coho directamente en la terminal.

Para Claude Desktop (sin acceso a terminal)

Usa este servidor MCP para darle al agente de IA acceso a las funcionalidades de Codehooks. Consulta la sección Configuración a continuación.

Funcionalidades disponibles

Base de datos y colecciones

• Consultar y actualizar colecciones (incluidos metadatos) con filtros y ordenamiento
• Crear y gestionar colecciones
• Importar/exportar datos (JSON, JSONL, CSV)
• Agregar esquemas e índices, limitar colecciones

Despliegue de código

• Desplegar funciones JavaScript sin servidor

Operaciones de archivos

• Subir archivos al almacenamiento en la nube
• Listar y explorar archivos
• Eliminar archivos
• Inspeccionar metadatos de archivos

Almacén de clave-valor

• Almacenar pares clave-valor
• Recuperar uno o muchos pares clave-valor
• Eliminar pares clave-valor
• Establecer tiempo de vida (TTL) para pares clave-valor

Operaciones del sistema

• Ver registros de la aplicación
• Acceder a la documentación de la API (documentación local para el agente MCP)

Configuración

Obtén el token de administrador de Codehooks (¡mantenlo en secreto!)

coho login
coho add-admintoken

Crea el script del servidor MCP

Crea una carpeta para los scripts de tu servidor MCP:

mkdir ~/mcp-servers
cd ~/mcp-servers

Para macOS/Linux - Crea codehooks.sh:

#!/bin/bash

# Set PATH to include common Docker locations
export PATH="/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:$PATH"

exec docker run --rm -i \
  --pull always \
  -e CODEHOOKS_PROJECT_NAME=your_project_name \
  -e CODEHOOKS_ADMIN_TOKEN=your_admin_token \
  -e CODEHOOKS_SPACE=your_space_name \
  ghcr.io/restdb/codehooks-mcp:latest

Hazlo ejecutable:

chmod +x ~/mcp-servers/codehooks.sh

Para Windows - Crea codehooks.bat:

@echo off
docker run --rm -i ^
  --pull always ^
  -e CODEHOOKS_PROJECT_NAME=your_project_name ^
  -e CODEHOOKS_ADMIN_TOKEN=your_admin_token ^
  -e CODEHOOKS_SPACE=your_space_name ^
  ghcr.io/restdb/codehooks-mcp:latest

Reemplaza your_project_name, your_admin_token y your_space_name con tus valores reales.

Configurar para Claude Desktop

Agrega a tu claude_desktop_config.json:

macOS/Linux:

{
  "mcpServers": {
    "codehooks": {
      "command": "/Users/username/mcp-servers/codehooks.sh"
    }
  }
}

Windows:

{
  "mcpServers": {
    "codehooks": {
      "command": "C:\\Users\\username\\mcp-servers\\codehooks.bat"
    }
  }
}

Configurar para Cursor

Agrega a tu ~/.cursor/mcp.json:

macOS/Linux:

{
  "mcpServers": {
    "codehooks": {
      "command": "/Users/username/mcp-servers/codehooks.sh"
    }
  }
}

Windows:

{
  "mcpServers": {
    "codehooks": {
      "command": "C:\\Users\\username\\mcp-servers\\codehooks.bat"
    }
  }
}

Reemplaza username con tu nombre de usuario real.

Ejemplos de solicitudes

• "Construye un sistema de encuestas completo: crea una base de datos, despliega una API para recopilar respuestas y agrega endpoints de búsqueda/análisis"
• "Configura un rastreador de inventario en tiempo real: importa mi CSV de productos, crea webhooks de actualización de existencias y construye alertas de stock bajo"
• "Construye un pipeline de procesamiento de webhooks: recibe webhooks de múltiples fuentes, transforma y valida datos, y luego dispara acciones automáticas"
• "Construye un sistema de gestión de contenido: crea endpoints de subida de archivos, configura una base de datos de metadatos y despliega APIs de entrega de contenido"
• "Configura copias de seguridad automáticas de datos: exporta mis colecciones a archivos JSON, guárdalos con marcas de tiempo y crea endpoints de restauración"

Cómo funcionan estos ejemplos

Sistema completo de encuestas

El agente de IA haría:

1. Crear colecciones (surveys, responses) para el almacenamiento de datos
2. Agregar esquemas para la validación y estructura de datos
3. Desplegar endpoints JavaScript como POST /surveys y GET /surveys/:id/analytics
4. Crear índices en los campos de respuesta para búsqueda rápida y análisis

Rastreador de inventario en tiempo real

El agente de IA haría:

1. Importar tu CSV para poblar la colección products
2. Desplegar manejadores de webhook para POST /inventory/update y GET /inventory/low-stock
3. Configurar almacenamiento de clave-valor para umbrales y configuraciones de alertas
4. Crear índices en SKU y niveles de stock para consultas en tiempo real

Pipeline de procesamiento de webhooks

El agente de IA haría:

1. Desplegar receptores de webhook como POST /webhooks/stripe y POST /webhooks/github
2. Crear colecciones para webhook_logs, processed_events y failed_events
3. Configurar reglas de transformación de datos y esquemas de validación para cada fuente de webhook
4. Usar el almacén de clave-valor para limitación de tasa y detección de duplicados con TTL
5. Desplegar disparadores de acciones que envían correos, actualizan bases de datos o llaman a otras API basados en datos de webhook

Sistema de gestión de contenido

El agente de IA haría:

1. Crear colecciones para content, media y users
2. Desplegar endpoints de subida de archivos con POST /upload y GET /content/:id
3. Subir y gestionar archivos estáticos para la entrega de contenido
4. Almacenar metadatos que vinculen archivos con registros de contenido usando índices de búsqueda

Copias de seguridad automáticas de datos

El agente de IA haría:

1. Exportar colecciones a formato JSON con marcas de tiempo
2. Subir archivos de respaldo al almacenamiento en la nube automáticamente
3. Desplegar APIs de restauración como GET /backups y POST /restore/:backup-id
4. Almacenar metadatos de respaldo en el almacén de clave-valor para seguimiento y gestión

Cada ejemplo demuestra cómo múltiples herramientas MCP trabajan juntas para crear sistemas completos y listos para producción a través de conversación natural con tu agente de IA.

Investigadores de seguridad

Agradecemos a las siguientes personas por su divulgación responsable y por ayudar a mejorar la seguridad de este proyecto:

• Liran Tal – Reportó una vulnerabilidad de inyección de comandos en la herramienta query_collection (mayo de 2025)

Licencia

Este proyecto está licenciado bajo la Licencia MIT.