Cursor MCP Installer

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

🚀 NEU: Universal MCP Installer v1.0.0 — Vollständige Neufassung von cursor-mcp-installer. Unterstützt jetzt 6 KI-Clients (Claude Desktop, Cursor, VS Code, OpenClaw, Claude Code, ChatGPT), ist plattformübergreifend (macOS, Windows, Linux), bietet echte MCP-Handshake-Validierung und ein gebrandetes Web-Dashboard. Aktualisiert auf MCP SDK 1.29.0.

🖥️ Web-Dashboard verfügbar! Starten Sie mit npx universal-mcp-installer --ui, um alles über eine visuelle Oberfläche zu verwalten. Siehe Verwendung des Dashboards unten.

Kurzanleitung

Schritt 1: Installieren Sie einen MCP-Server (Ein Befehl)

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

Das ist alles. Der Installer erkennt, welche KI-Clients Sie installiert haben, und schreibt die korrekte Konfiguration für jeden einzelnen.

Schritt 2: Oder als MCP-Tool hinzufügen (Lassen Sie Ihre KI andere MCP-Server installieren)

Fügen Sie dies zur MCP-Konfiguration Ihres KI-Clients hinzu:

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"]
    }
  }
}

Schritt 3: Starten Sie Ihren KI-Client neu

Schließen Sie Ihren KI-Client und öffnen Sie ihn erneut, um die Konfigurationsänderungen anzuwenden.

Schritt 4: Bitten Sie Ihre KI, Server zu installieren

Install the filesystem MCP server

oder

Install the web search MCP server

Der Installer stellt drei Tools bereit, die Ihre KI aufrufen kann:

Related MCP server: MCP Server Template for Cursor IDE

Verwendung des Dashboards

Starten Sie die visuelle Oberfläche:

npx universal-mcp-installer --ui

Dies öffnet die Weboberfläche in Ihrem Browser unter http://localhost:3939:

1. System-Panel — Der obere Bereich erkennt automatisch Ihr Betriebssystem und alle verfügbaren Runtimes (Node, npm, uvx, Python, git), sodass Sie auf einen Blick sehen können, was auf Ihrem Rechner verfügbar ist.

2. KI-Clients — Jeder erkannte Client erhält eine Karte, die seinen Namen, den Pfad zur Konfigurationsdatei und die Anzahl der bereits konfigurierten MCP-Server anzeigt. Verwenden Sie den Umschalter auf jeder Karte, um ihn für die nächste Installation einzubeziehen oder auszuschließen. Nicht installierte Clients erscheinen ausgegraut.

3. Installieren — Geben Sie einen Paketnamen ein (npm-Paket, Git-URL oder lokaler Pfad), wählen Sie eine Methode aus dem Dropdown-Menü (Auto / npm / uvx / git / local) und klicken Sie auf den grünen Installieren-Button. Der Installer löst das Paket auf, schreibt die Konfiguration in jeden aktivierten Client und validiert per MCP-Handshake.

4. Fortschritt & Ergebnisse — Eine Echtzeit-Timeline zeigt jeden Schritt (Auflösen, Konfiguration schreiben, Validieren) mit Live-Status-Updates via WebSocket. Nach Abschluss zeigt ein Gesundheitsbericht-Raster Erfolg/Fehlschlag pro Client mit Tool-Anzahl, Latenz und Hinweisen zur Fehlerbehebung bei Problemen.

Unterstützte Clients

Wo befinden sich die Konfigurationsdateien?

Funktionen

• Automatische Erkennung installierter KI-Clients und deren Konfigurationspfade

• Runtime-Erkennung für Node.js, npm, npx, uvx, Python und git

• Mehrere Installationsmethoden: npm, uvx, git clone, lokaler Pfad

• Konfigurationssicherheit: erstellt Backups bestehender Konfigurationen, atomare Schreibvorgänge, überschreibt niemals unabhängige Schlüssel

• Echte MCP-Handshake-Validierung: startet den Server, sendet initialize/initialized, ruft tools/list auf

• Gesundheitsberichte: strukturierte Erfolg/Fehlschlag-Anzeige pro Client mit Tool-Anzahl, Latenz und Hinweisen zur Fehlerbehebung

• Wiederherstellung bei bekannten Problemen: 13+ Fehlercodes mit umsetzbaren Lösungsvorschlägen

• Plattformübergreifend: Windows cmd /c npx-Wrapping, Linux XDG-Pfade, macOS launchd-Unterstützung

• Service-Templates: Generierung von Konfigurationen für launchd (macOS), systemd (Linux) oder Aufgabenplanung (Windows)

• Web-Dashboard: gebrandete React-UI mit Echtzeit-WebSocket-Fortschritts-Updates

Voraussetzungen

• Node.js v18 oder neuer

• Mindestens ein unterstützter KI-Client installiert

Optional:

• uv/uvx für Python MCP-Server

• git für die Installation aus Repositories

CLI-Referenz

# 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

CLI-Optionen

API-Endpunkte (Dashboard-Modus)

Beim Ausführen mit --ui ist eine lokale API verfügbar:

Entwicklung

# 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

Projektstruktur

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

Changelog

v1.0.0 (Universelle Neufassung)

• Vollständige Neufassung von cursor-mcp-installer (v0.1.3) zu universal-mcp-installer

• Upgrade des MCP SDK von ^1.0.1 auf ^1.29.0 (28 Nebenversionen)

• Unterstützung für 6 KI-Clients hinzugefügt (zuvor nur Cursor)

• Echte MCP-Handshake-Validierung hinzugefügt (zuvor keine)

• Plattformübergreifende Unterstützung mit plattformspezifischen Konfigurationspfaden hinzugefügt

• CLI mit detect-, install-, validate-Befehlen hinzugefügt

• Web-Dashboard mit React + Tailwind + WebSocket hinzugefügt

• 50+ echte Tests hinzugefügt (zuvor echo "No tests specified")

• Datenbank zur Wiederherstellung bei bekannten Problemen hinzugefügt

• Generierung von Service-Templates hinzugefügt (launchd, systemd, Aufgabenplanung)

• rimraf/spawn-rx durch Node-eigene Funktionen ersetzt

• Behoben: require.resolve im ESM-Kontext

• Behoben: console.error/console.warn beschädigte den stdio JSON-RPC-Stream

• Vollständige TypeScript-Quelle (zuvor nur kompiliertes JS-Artefakt)

Lizenz

MIT