MCP Project Helper

mcp-project-helper

Un servidor MCP (Model Context Protocol) ligero y extensible para ejecutar herramientas basadas en prompts y utilidades de archivos. Diseñado para una fácil integración, prueba y extensión con prompts personalizados.

Características

• Herramientas basadas en prompts: Añade fácilmente nuevas herramientas escribiendo simples archivos de prompt JSON.
• Utilidades de archivos: Incluye herramientas para leer, escribir, mover y eliminar archivos y directorios.
• Prompts personalizados: Coloca tus propias definiciones de prompt en el directorio custom_prompts/.
• Múltiples transportes: Soporta STDIO, SSE y HTTP para una integración flexible.
• Pruebas exhaustivas: Incluye un script de prueba para verificar todos los endpoints de las herramientas.

Primeros pasos

Compilar localmente

make build-local

⚡ Inicio rápido

Instalar mediante go install

Para instalar rápidamente la última versión desde el repositorio:

go install github.com/ad/mcp-project-helper@latest

El binario aparecerá en $GOBIN o $HOME/go/bin (asegúrate de que esta ruta esté en tu $PATH).

1. Compilar desde el código fuente

# Clone the repository
git clone https://github.com/ad/mcp-project-helper.git
cd mcp-project-helper

go mod tidy

# Local build
make build-local

# Or manually
go build -o mcp-project-helper main.go

# Local build
make build-local

# Or manually
go build -o mcp-project-helper main.go

# Docker build
make build

Ejecutar el servidor

• STDIO (predeterminado):

./mcp-project-helper

• SSE:

  ./mcp-project-helper -transport sse -port 8080
  

• HTTP:

  ./mcp-project-helper -transport http -port 8080
  

Ejecutar pruebas

./test.sh

🔌 Integración

VS Code

go install github.com/ad/mcp-project-helper@latest

Añade a settings.json:

{
  "mcp": {
    "servers": {
      "helper": {
        "type": "stdio",
        "command": "/absolute/path/to/project-helper",
        "args": ["-transport", "stdio"]
      }
    }
  }
}

Docker (VS Code)

{
  "mcp": {
    "servers": {
      "helper": {
        "type": "stdio",
        "command": "docker",
        "args": [
          "run", "--rm", "-i",
          "danielapatin/mcp-project-helper:latest",
          "-transport", "stdio"
        ]
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "helper": {
      "command": "/absolute/path/to/mcp-project-helper",
      "args": ["-transport", "stdio"]
    }
  }
}

Añadir herramientas personalizadas

1. Crea un archivo JSON en custom_prompts/ (consulta palette.json para ver un ejemplo).
2. Cada herramienta debe definir un campo description y un campo prompt.
3. La herramienta se registrará automáticamente y estará disponible a través del protocolo MCP.

Herramientas de ejemplo

• tool-generator: Genera una descripción de herramienta y una plantilla de prompt basada en una consulta del usuario.
• palette: Sugiere una paleta de colores armoniosa para un color dado.

Estructura del proyecto

• main.go — Punto de entrada principal del servidor
• prompts/ — Herramientas de prompt integradas
• custom_prompts/ — Herramientas de prompt definidas por el usuario
• test.sh — Script de prueba de extremo a extremo
• Makefile — Comandos de compilación y ejecución

Licencia

MIT