minorsathya-cloud/mcp-installer-claude-skill

¿Qué hace mcp-installer-claude-skill?

Instala cualquier servidor MCP en Claude Desktop sin errores. Maneja diagnóstico del entorno, todos los tipos de autenticación, escritura de configuración con rutas absolutas y verificación de extremo a extremo. Incluye referencias para 20 servidores MCP populares y un flujo genérico para cualquier servidor MCP no listado.

¿Qué hace este skill?

Este skill automatiza la instalación de servidores del Model Context Protocol (MCP) en Claude Desktop, eliminando errores comunes. Realiza:

• Diagnóstico del entorno: Verifica Node.js, Python, variables de entorno, permisos de escritura y otras dependencias.
• Manejo de autenticación: Soporta API keys, OAuth, tokens de acceso y autenticación básica, seleccionando automáticamente la estrategia adecuada.
• Escritura de configuración: Genera el bloque de configuración mcpServers en claude_desktop_config.json usando rutas absolutas para evitar errores de ruta relativa.
• Verificación: Prueba el servidor MCP con un comando de prueba y monitorea la salida para confirmar que responde correctamente.

Plataformas soportadas

• Claude Desktop (Windows, macOS, Linux)
• También funciona en entornos similares como Cursor o Codex con ajustes menores

Cómo funciona

1. Entrada del usuario: El usuario proporciona el nombre del servidor MCP y opcionalmente parámetros de autenticación.
2. Diagnóstico: El skill verifica que Node.js esté instalado (versión 18+), que Python 3 esté disponible, y que el archivo de configuración de Claude Desktop exista.
3. Selección de autenticación: Si el servidor requiere autenticación, el skill guía al usuario para elegir el método y proporciona las credenciales necesarias.
4. Instalación: Instala el paquete MCP vía npm o pip según corresponda.
5. Configuración: Escribe la entrada en claude_desktop_config.json con rutas absolutas y opciones de seguridad.
6. Verificación: Ejecuta el servidor y confirma que se conecte correctamente.

Referencias de MCPs populares

El skill incluye plantillas y configuraciones para más de 20 servidores MCP populares, entre ellos:

• PostgreSQL: @anthropic/mcp-postgres
• GitHub: @anthropic/mcp-github
• Slack: @anthropic/mcp-slack
• Filesystem: @anthropic/mcp-filesystem
• Puppeteer: @anthropic/mcp-puppeteer
• SQLite: @anthropic/mcp-sqlite
• ... y muchos más.

Flujo genérico

Para cualquier servidor MCP no listado en las referencias, el skill usa un flugo genérico:

1. Solicita al usuario el nombre del paquete y el comando de inicio.
2. Instala el paquete con el gestor de paquetes apropiado.
3. Escribe la configuración con el comando proporcionado, usando rutas absolutas.
4. Verifica la funcionalidad enviando un mensaje de prueba.

Notas de uso

• Rutas absolutas: El skill siempre escribe rutas completas del sistema (/usr/bin/node) en lugar de rutas relativas para evitar errores cuando el directorio de trabajo cambia.
• Idempotencia: Si el servidor ya está configurado, el skill no duplica entradas; actualiza la existente si es necesario.
• Seguridad: Las credenciales se almacenan en el archivo de configuración local, nunca se envían a servidores externos.

Ejemplo

# Instalar el servidor MCP de PostgreSQL
> mcp-installer postgres --auth api-key --key "mi-api-key"

Esto resultará en una entrada como:

{
  "mcpServers": {
    "postgres": {
      "command": "/usr/local/bin/node",
      "args": ["/usr/local/bin/mcp-postgres", "--api-key", "mi-api-key"],
      "env": {
        "API_KEY": "mi-api-key"
      }
    }
  }
}