Cursor MCP Installer

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

🚀 НОВИНКА: Universal MCP Installer v1.0.0 — Полная переработка cursor-mcp-installer. Теперь поддерживает 6 ИИ-клиентов (Claude Desktop, Cursor, VS Code, OpenClaw, Claude Code, ChatGPT), кроссплатформенность (macOS, Windows, Linux), настоящую проверку рукопожатия MCP и фирменную веб-панель управления. Обновлено до MCP SDK 1.29.0.

🖥️ Доступна веб-панель управления! Запустите с помощью npx universal-mcp-installer --ui, чтобы управлять всем через визуальный интерфейс. См. Использование панели управления ниже.

Краткое руководство

Шаг 1: Установка MCP-сервера (одной командой)

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

Это всё. Установщик определяет, какие ИИ-клиенты у вас установлены, и записывает правильную конфигурацию для каждого из них.

Шаг 2: Или добавьте как MCP-инструмент (позвольте вашему ИИ устанавливать другие MCP-серверы)

Добавьте это в конфигурацию MCP вашего ИИ-клиента:

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

Шаг 3: Перезапустите ваш ИИ-клиент

Закройте и снова откройте ваш ИИ-клиент, чтобы применить изменения конфигурации.

Шаг 4: Попросите ваш ИИ установить серверы

Install the filesystem MCP server

или

Install the web search MCP server

Установщик предоставляет три инструмента, которые может вызвать ваш ИИ:

Related MCP server: MCP Server Template for Cursor IDE

Использование панели управления

Запустите визуальный интерфейс:

npx universal-mcp-installer --ui

Это откроет веб-интерфейс в вашем браузере по адресу http://localhost:3939:

1. Панель системы — Верхний раздел автоматически определяет вашу ОС и все доступные среды выполнения (Node, npm, uvx, Python, git), чтобы вы могли сразу увидеть, что доступно на вашем компьютере.

2. ИИ-клиенты — Каждый обнаруженный клиент получает карточку с указанием его имени, пути к файлу конфигурации и количества уже настроенных MCP-серверов. Используйте переключатель на каждой карточке, чтобы включить или исключить его из следующей установки. Неустановленные клиенты отображаются серым цветом.

3. Установка — Введите имя пакета (npm-пакет, git-ссылка или локальный путь), выберите метод из выпадающего списка (Auto / npm / uvx / git / local) и нажмите зеленую кнопку Install. Установщик разрешает пакет, записывает конфигурацию в каждый выбранный клиент и проверяет через рукопожатие MCP.

4. Прогресс и результаты — Временная шкала в реальном времени показывает каждый шаг (разрешение, запись конфигурации, проверка) с обновлениями статуса через WebSocket. После завершения сетка отчета о работоспособности показывает результат (пройдено/не пройдено) для каждого клиента с количеством инструментов, задержкой и подсказками по восстановлению в случае сбоев.

Поддерживаемые клиенты

Где находятся файлы конфигурации?

Функции

• Автоопределение установленных ИИ-клиентов и путей к их конфигурациям

• Определение среды выполнения для Node.js, npm, npx, uvx, Python и git

• Несколько методов установки: npm, uvx, git clone, локальный путь

• Безопасность конфигурации: создание резервных копий существующих конфигураций, атомарная запись, отсутствие перезаписи несвязанных ключей

• Настоящая проверка рукопожатия MCP: запуск сервера, отправка initialize/initialized, вызов tools/list

• Отчеты о работоспособности: структурированные данные (пройдено/не пройдено) для каждого клиента с количеством инструментов, задержкой и подсказками по восстановлению

• Восстановление после известных проблем: 13+ кодов ошибок с практическими рекомендациями по исправлению

• Кроссплатформенность: обертка Windows cmd /c npx, пути Linux XDG, поддержка macOS launchd

• Шаблоны служб: генерация конфигураций для launchd (macOS), systemd (Linux) или планировщика задач (Windows)

• Веб-панель управления: фирменный React UI с обновлениями прогресса через WebSocket в реальном времени

Предварительные требования

• Node.js v18 или новее

• Установлен хотя бы один поддерживаемый ИИ-клиент

Опционально:

• uv/uvx для Python MCP-серверов

• git для установки из репозиториев

Справочник 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

Опции CLI

API-эндпоинты (режим панели управления)

При запуске с --ui доступен локальный API:

Разработка

# 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

Структура проекта

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

Журнал изменений

v1.0.0 (Универсальная переработка)

• Полная переработка с cursor-mcp-installer (v0.1.3) на universal-mcp-installer

• Обновление MCP SDK с ^1.0.1 до ^1.29.0 (28 минорных версий)

• Добавлена поддержка 6 ИИ-клиентов (ранее только Cursor)

• Добавлена настоящая проверка рукопожатия MCP (ранее отсутствовала)

• Добавлена кроссплатформенная поддержка с путями конфигурации для конкретных платформ

• Добавлен CLI с командами detect, install, validate

• Добавлена веб-панель управления с React + Tailwind + WebSocket

• Добавлено 50+ реальных тестов (ранее было echo "No tests specified")

• Добавлена база данных восстановления после известных ошибок

• Добавлена генерация шаблонов служб (launchd, systemd, планировщик задач)

• Заменены rimraf/spawn-rx на встроенные средства Node

• Исправлено: require.resolve в контексте ESM

• Исправлено: console.error/console.warn повреждали поток JSON-RPC stdio

• Полный исходный код на TypeScript (ранее был только скомпилированный JS-артефакт)

Лицензия

MIT