Codehooks.io

Integre com a plataforma de backend serverless Codehooks.io.

Documentação

Servidor MCP Codehooks.io

Um servidor MCP (Model Context Protocol) que fornece a agentes de IA operações de banco de dados, implantação de código serverless e recursos de gerenciamento de arquivos na plataforma Codehooks.io.

Quando usar este MCP vs. CLI diretamente

Ambiente	Tem terminal?	Abordagem recomendada
Claude Code	Sim	Use a CLI `coho` diretamente
Cursor	Sim	Use a CLI `coho` diretamente
Claude Desktop	Não	Este servidor MCP

Para agentes de IA com acesso ao terminal (Claude Code, Cursor, etc.)

Usar a CLI do Codehooks diretamente é mais simples e flexível:

Instale a CLI: npm install -g codehooks
Faça login: coho login
Obtenha o prompt de IA: coho prompt
Ou consulte a documentação online: https://codehooks.io/llms.txt

O agente pode então executar comandos coho diretamente no terminal.

Para Claude Desktop (sem acesso ao terminal)

Use este servidor MCP para dar à IA acesso à funcionalidade do Codehooks. Veja a seção Configuração abaixo.

Funcionalidades disponíveis

Banco de dados e coleções

Consultar e atualizar coleções (incluindo metadados) com filtros e ordenação
Criar e gerenciar coleções
Importar/exportar dados (JSON, JSONL, CSV)
Adicionar esquemas e índices, limitar coleções

Implantação de código

Implantar funções serverless em JavaScript

Operações de arquivo

Enviar arquivos para armazenamento em nuvem
Listar e navegar por arquivos
Excluir arquivos
Inspecionar metadados de arquivos

Armazenamento chave-valor

Armazenar pares chave-valor
Recuperar um ou vários pares chave-valor
Excluir pares chave-valor
Definir tempo de vida (TTL) para pares chave-valor

Operações do sistema

Visualizar logs de aplicação
Acessar documentação da API (documentação local para o agente MCP)

Configuração

Obtenha o token de administrador do Codehooks (mantenha-o em segredo!)

coho login
coho add-admintoken

Criar script do servidor MCP

Crie uma pasta para seus scripts do servidor MCP:

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

Para macOS/Linux - Crie 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

Torne-o executável:

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

Para Windows - Crie 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

Substitua your_project_name, your_admin_token e your_space_name pelos seus valores reais.

Configurar para Claude Desktop

Adicione ao seu 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

Adicione ao seu ~/.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"
    }
  }
}

Substitua username pelo seu nome de usuário real.

Exemplos de solicitações

"Crie um sistema de pesquisa completo: crie um banco de dados, implante uma API para coletar respostas e adicione endpoints de busca/análise"
"Configure um rastreador de inventário em tempo real: importe meu CSV de produtos, crie webhooks de atualização de estoque e crie alertas de estoque baixo"
"Crie um pipeline de processamento de webhooks: receba webhooks de várias fontes, transforme e valide dados e depois acione ações automatizadas"
"Crie um sistema de gerenciamento de conteúdo: crie endpoints de upload de arquivos, configure um banco de dados de metadados e implante APIs de entrega de conteúdo"
"Configure backups automatizados de dados: exporte minhas coleções para arquivos JSON, armazene-os com carimbos de data/hora e crie endpoints de restauração"

Como esses exemplos funcionam

Sistema de pesquisa completo

O agente de IA faria:

Criar coleções (surveys, responses) para armazenamento de dados
Adicionar esquemas para validação e estrutura de dados
Implantar endpoints JavaScript como POST /surveys e GET /surveys/:id/analytics
Criar índices nos campos de resposta para busca rápida e análise

Rastreador de inventário em tempo real

O agente de IA faria:

Importar seu CSV para popular a coleção products
Implantar manipuladores de webhook para POST /inventory/update e GET /inventory/low-stock
Configurar armazenamento chave-valor para limites e configurações de alerta
Criar índices em SKU e níveis de estoque para consultas em tempo real

Pipeline de processamento de webhooks

O agente de IA faria:

Implantar receptores de webhook como POST /webhooks/stripe e POST /webhooks/github
Criar coleções para webhook_logs, processed_events e failed_events
Configurar regras de transformação de dados e esquemas de validação para cada fonte de webhook
Usar armazenamento chave-valor para limitação de taxa e detecção de duplicatas com TTL
Implantar gatilhos de ação que enviam e-mails, atualizam bancos de dados ou chamam outras APIs com base nos dados do webhook

Sistema de gerenciamento de conteúdo

O agente de IA faria:

Criar coleções para content, media e users
Implantar endpoints de upload de arquivos com POST /upload e GET /content/:id
Enviar e gerenciar arquivos estáticos para entrega de conteúdo
Armazenar metadados vinculando arquivos a registros de conteúdo com índices de busca

Backups automatizados de dados

O agente de IA faria:

Exportar coleções para o formato JSON com carimbos de data/hora
Enviar arquivos de backup para armazenamento em nuvem automaticamente
Implantar APIs de restauração como GET /backups e POST /restore/:backup-id
Armazenar metadados de backup no armazenamento chave-valor para rastreamento e gerenciamento

Cada exemplo demonstra como várias ferramentas MCP trabalham juntas para criar sistemas completos e prontos para produção por meio de conversa natural com seu agente de IA.

Pesquisadores de segurança

Agradecemos aos seguintes indivíduos pela divulgação responsável e por ajudar a melhorar a segurança deste projeto:

Liran Tal – Relatou uma vulnerabilidade de injeção de comandos na ferramenta query_collection (maio de 2025)

Licença

Este projeto está licenciado sob a Licença MIT.