Cursor MCP Installer

             _   _ _   _ _____     _______ ____  ____    _    _     
            | | | | \ | |_ _\ \   / / ____|  _ \/ ___|  / \  | |    
            | | | |  \| || | \ \ / /|  _| | |_) \___ \ / _ \ | |    
            | |_| | |\  || |  \ V / | |___|  _ < ___) / ___ \| |___ 
             \___/|_| \_|___|  \_/  |_____|_| \_\____/_/   \_\_____|
                                                          
      __  __  ____ ____    ___ _   _ ____ _____  _    _     _     _____ ____  
     |  \/  |/ ___|  _ \  |_ _| \ | / ___|_   _|/ \  | |   | |   | ____|  _ \ 
     | |\/| | |   | |_) |  | ||  \| \___ \ | | / _ \ | |   | |   |  _| | |_) |
     | |  | | |___|  __/   | || |\  |___) || |/ ___ \| |___| |___| |___|  _ < 
     |_|  |_|\____|_|     |___|_| \_|____/ |_/_/   \_\_____|_____|_____|_| \_\

🚀 NUEVO: Universal MCP Installer v1.0.0 — Reescritura completa de cursor-mcp-installer. Ahora es compatible con 6 clientes de IA (Claude Desktop, Cursor, VS Code, OpenClaw, Claude Code, ChatGPT), multiplataforma (macOS, Windows, Linux), validación real de handshake MCP y un panel de control web con marca. Actualizado al SDK de MCP 1.29.0.

🖥️ ¡Panel de control web disponible! Inícialo con npx universal-mcp-installer --ui para gestionar todo desde una interfaz visual. Consulta Uso del panel de control a continuación.

Guía de inicio rápido

Paso 1: Instalar un servidor MCP (un solo comando)

npx universal-mcp-installer install @modelcontextprotocol/server-memory

Eso es todo. El instalador detecta qué clientes de IA tienes instalados y escribe la configuración correcta para cada uno.

Paso 2: O agrégalo como una herramienta MCP (deja que tu IA instale otros servidores MCP)

Agrega esto a la configuración MCP de tu cliente de IA:

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "MCP Installer": {
      "command": "npx",
      "type": "stdio",
      "args": ["-y", "universal-mcp-installer"]
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "MCP Installer": {
      "command": "npx",
      "args": ["-y", "universal-mcp-installer"]
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "mcpInstaller": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "universal-mcp-installer"]
    }
  }
}

Paso 3: Reinicia tu cliente de IA

Cierra y vuelve a abrir tu cliente de IA para aplicar los cambios de configuración.

Paso 4: Pide a tu IA que instale servidores

Install the filesystem MCP server

o

Install the web search MCP server

El instalador expone tres herramientas que tu IA puede llamar:

Related MCP server: MCP Server Template for Cursor IDE

Uso del panel de control

Inicia la interfaz visual:

npx universal-mcp-installer --ui

Esto abre la interfaz web en tu navegador en http://localhost:3939:

1. Panel del sistema — La sección superior detecta automáticamente tu SO y todos los entornos de ejecución disponibles (Node, npm, uvx, Python, git) para que puedas ver de un vistazo qué hay disponible en tu máquina.

2. Clientes de IA — Cada cliente detectado obtiene una tarjeta que muestra su nombre, la ruta del archivo de configuración y cuántos servidores MCP ya están configurados. Usa el interruptor en cada tarjeta para incluirlo o excluirlo de la próxima instalación. Los clientes no instalados aparecen atenuados.

3. Instalar — Escribe un nombre de paquete (paquete npm, URL de git o ruta local), elige un método del menú desplegable (Auto / npm / uvx / git / local) y presiona el botón verde Instalar. El instalador resuelve el paquete, escribe la configuración en cada cliente seleccionado y valida mediante handshake MCP.

4. Progreso y resultados — Una línea de tiempo en tiempo real muestra cada paso (resolución, escritura de configuración, validación) con actualizaciones de estado en vivo a través de WebSocket. Una vez completado, una cuadrícula de informe de salud muestra el éxito/fallo por cliente con recuentos de herramientas, latencia y sugerencias de recuperación para cualquier fallo.

Clientes compatibles

¿Dónde están los archivos de configuración?

Características

• Autodetección de clientes de IA instalados y sus rutas de configuración

• Detección de entorno de ejecución para Node.js, npm, npx, uvx, Python y git

• Múltiples métodos de instalación: npm, uvx, git clone, ruta local

• Seguridad de configuración: realiza copias de seguridad de las configuraciones existentes, escrituras atómicas, nunca sobrescribe claves no relacionadas

• Validación real de handshake MCP: inicia el servidor, envía initialize/initialized, llama a tools/list

• Informes de salud: éxito/fallo estructurado por cliente con recuento de herramientas, latencia y sugerencias de recuperación

• Recuperación de problemas conocidos: más de 13 códigos de error con sugerencias de solución accionables

• Multiplataforma: envoltorio cmd /c npx para Windows, rutas XDG para Linux, soporte para launchd en macOS

• Plantillas de servicio: genera configuraciones para launchd (macOS), systemd (Linux) o Programador de tareas (Windows)

• Panel de control web: interfaz React con marca y actualizaciones de progreso en tiempo real mediante WebSocket

Requisitos previos

• Node.js v18 o posterior

• Al menos un cliente de IA compatible instalado

Opcional:

• uv/uvx para servidores MCP de Python

• git para instalar desde repositorios

Referencia de CLI

# Detect your system, runtimes, and installed AI clients
npx universal-mcp-installer detect

# Install an MCP server to all detected clients
npx universal-mcp-installer install @modelcontextprotocol/server-memory

# Install to specific clients only
npx universal-mcp-installer install my-server --clients cursor,claude-desktop

# Install with environment variables
npx universal-mcp-installer install my-server --env API_KEY=sk-123

# Install from a git repository
npx universal-mcp-installer install https://github.com/user/mcp-server.git

# Install from a local directory
npx universal-mcp-installer install ./my-local-server --method local

# Validate an MCP server by running the handshake
npx universal-mcp-installer validate npx -y @modelcontextprotocol/server-memory

# Launch the web dashboard
npx universal-mcp-installer --ui

Opciones de CLI

Puntos finales de API (modo panel de control)

Al ejecutar con --ui, hay una API local disponible:

Desarrollo

# Clone and install
git clone https://github.com/matthewdcage/cursor-mcp-installer.git
cd cursor-mcp-installer
npm install

# Build the server
npm run build

# Build the dashboard
cd dashboard && npm install && npm run build && cd ..

# Run tests (real MCP handshake, no mocks)
npm test

# Watch mode
npm run dev

Estructura del proyecto

src/
  index.ts               MCP server entry (stdio)
  cli.ts                 CLI entry (npx)
  detect/                OS, runtime, client detection
  clients/               Config writers per AI client
  install/               Package resolution (npm, uvx, git, local)
  validate/              MCP handshake + health reports
  api/                   HTTP/WebSocket API for dashboard
  utils/                 Config I/O, logging, errors, platform utils
dashboard/               React + Vite + Tailwind web UI
tests/                   Unit, integration, E2E tests
docs/                    Localized official MCP docs

Registro de cambios

v1.0.0 (Reescritura universal)

• Reescritura completa de cursor-mcp-installer (v0.1.3) a universal-mcp-installer

• Actualización del SDK de MCP de ^1.0.1 a ^1.29.0 (28 versiones menores)

• Se agregó soporte para 6 clientes de IA (antes solo Cursor)

• Se agregó validación real de handshake MCP (antes no había)

• Se agregó soporte multiplataforma con rutas de configuración específicas de la plataforma

• Se agregó CLI con comandos detect, install, validate

• Se agregó panel de control web con React + Tailwind + WebSocket

• Se agregaron más de 50 pruebas reales (antes era echo "No tests specified")

• Se agregó base de datos de recuperación de errores de problemas conocidos

• Se agregó generación de plantillas de servicio (launchd, systemd, Programador de tareas)

• Se reemplazó rimraf/spawn-rx con funciones integradas de Node

• Corregido: require.resolve en contexto ESM

• Corregido: console.error/console.warn corrompiendo el flujo JSON-RPC de stdio

• Fuente completa en TypeScript (antes era un artefacto compilado solo en JS)

Licencia

MIT