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

License: MIT npm version MCP Compatible npm downloads

🚀 新功能：Universal MCP Installer v1.0.0 — 对 cursor-mcp-installer 进行了全面重写。现在支持 6 个 AI 客户端（Claude Desktop、Cursor、VS Code、OpenClaw、Claude Code、ChatGPT），跨平台（macOS、Windows、Linux），具备真正的 MCP 握手验证，以及一个 品牌化 Web 仪表盘。已升级至 MCP SDK 1.29.0。

🖥️ Web 仪表盘现已上线！ 使用 npx universal-mcp-installer --ui 启动，即可通过可视化界面管理一切。请参阅下方的使用仪表盘。

快速入门指南

第 1 步：安装 MCP 服务器（一条命令）

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

就是这样。安装程序会自动检测您安装的 AI 客户端，并为每个客户端写入正确的配置。

第 2 步：或者作为 MCP 工具添加（让您的 AI 安装其他 MCP 服务器）

将此内容添加到您的 AI 客户端的 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 步：重启您的 AI 客户端

关闭并重新打开您的 AI 客户端以应用配置更改。

第 4 步：让您的 AI 安装服务器

Install the filesystem MCP server

或者

Install the web search MCP server

安装程序提供了三个您的 AI 可以调用的工具：

工具	描述
`detect_system`	返回操作系统、架构、可用运行时和检测到的 AI 客户端
`install_mcp_server`	通过包名、git URL 或本地路径将服务器安装到选定的客户端
`validate_mcp_server`	通过 MCP 握手验证服务器并返回结果

Related MCP server: MCP Server Template for Cursor IDE

使用仪表盘

启动可视化界面：

npx universal-mcp-installer --ui

这将在您的浏览器中打开 Web 界面 http://localhost:3939：

1. 系统面板 — 顶部区域会自动检测您的操作系统和所有可用运行时（Node、npm、uvx、Python、git），让您可以一目了然地查看机器上的可用资源。

2. AI 客户端 — 每个检测到的客户端都会显示一张卡片，包含其名称、配置文件路径以及已配置的 MCP 服务器数量。使用每张卡片上的切换开关来决定是否将其包含在下一次安装中。未安装的客户端将显示为灰色。

3. 安装 — 输入包名（npm 包、git URL 或本地路径），从下拉菜单中选择一种方法（Auto / npm / uvx / git / local），然后点击绿色的 Install 按钮。安装程序将解析包、写入配置到所有已勾选的客户端，并通过 MCP 握手进行验证。

4. 进度与结果 — 实时时间轴显示每一步（解析、写入配置、验证），并通过 WebSocket 提供实时状态更新。完成后，健康报告网格将显示每个客户端的通过/失败情况，包括工具数量、延迟以及针对任何故障的恢复提示。

支持的客户端

客户端	配置键	平台
Claude Desktop	`mcpServers`	macOS, Windows, Linux
Cursor	`mcpServers`	macOS, Windows, Linux
VS Code (Copilot)	`servers`	所有 (工作区级别)
OpenClaw / NemoClaw	`mcp.servers`	macOS, Linux
Claude Code	`mcpServers`	macOS, Windows, Linux
ChatGPT Desktop	HTTP Bridge	所有 (通过本地 HTTP 代理)

配置文件在哪里？

客户端	macOS	Windows	Linux
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`	`%APPDATA%\Claude\claude_desktop_config.json`	`~/.config/Claude/claude_desktop_config.json`
Cursor	`~/.cursor/mcp.json`	`%USERPROFILE%\.cursor\mcp.json`	`~/.cursor/mcp.json`
VS Code	`.vscode/mcp.json` (工作区)	`.vscode/mcp.json` (工作区)	`.vscode/mcp.json` (工作区)
OpenClaw	`~/.openclaw/openclaw.json`	-	`~/.openclaw/openclaw.json`
Claude Code	`.mcp.json` (项目根目录)	`.mcp.json` (项目根目录)	`.mcp.json` (项目根目录)

功能特性

自动检测已安装的 AI 客户端及其配置路径
运行时检测：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) 配置
Web 仪表盘：品牌化 React UI，具有实时 WebSocket 进度更新

先决条件

Node.js v18 或更高版本
至少安装了一个受支持的 AI 客户端

可选：

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 选项

选项	描述
`--clients <ids>`	逗号分隔的客户端 ID：`cursor`, `claude-desktop`, `vscode`, `openclaw`, `claude-code`, `chatgpt`
`--method <method>`	安装方法：`auto`, `npm`, `uvx`, `git`, `local`
`--env KEY=value`	环境变量（可重复）
`--args <arg>`	服务器参数（可重复）
`--no-validate`	安装后跳过 MCP 握手验证
`--port <number>`	仪表盘端口（默认：3939）

API 端点（仪表盘模式）

当使用 --ui 运行时，可以使用本地 API：

端点	方法	描述
`/api/system`	GET	系统信息、运行时、检测到的客户端
`/api/clients`	GET	客户端检测详情
`/api/install`	POST	触发安装
`/api/validate`	POST	触发 MCP 握手验证
`/ws`	WebSocket	实时进度事件

开发

# 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 个 AI 客户端的支持（之前仅支持 Cursor）
增加了真正的 MCP 握手验证（之前没有）
增加了跨平台支持，具有特定平台的配置路径
增加了带有 detect、install、validate 命令的 CLI
增加了带有 React + Tailwind + WebSocket 的 Web 仪表盘
增加了 50 多个真实测试（之前是 echo "No tests specified"）
增加了已知问题错误恢复数据库
增加了服务模板生成（launchd、systemd、任务计划程序）
用 Node 内置模块替换了 rimraf/spawn-rx
修复：ESM 上下文中的 require.resolve
修复：console.error/console.warn 破坏 stdio JSON-RPC 流的问题
完整的 TypeScript 源码（之前仅为编译后的 JS 制品）

许可证

MIT

Cursor MCP Installer

快速入门指南

第 1 步：安装 MCP 服务器（一条命令）

第 2 步：或者作为 MCP 工具添加（让您的 AI 安装其他 MCP 服务器）

Cursor (`~/.cursor/mcp.json`)

Claude Desktop (`claude_desktop_config.json`)

VS Code (`.vscode/mcp.json`)

第 3 步：重启您的 AI 客户端

第 4 步：让您的 AI 安装服务器

使用仪表盘

支持的客户端

配置文件在哪里？

功能特性

先决条件

CLI 参考

CLI 选项

API 端点（仪表盘模式）

开发

项目结构

更新日志

v1.0.0 (通用重写版)

许可证

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API

快速入门指南

第 1 步：安装 MCP 服务器（一条命令）

第 2 步：或者作为 MCP 工具添加（让您的 AI 安装其他 MCP 服务器）

Cursor (~/.cursor/mcp.json)

Claude Desktop (claude_desktop_config.json)

VS Code (.vscode/mcp.json)

第 3 步：重启您的 AI 客户端

第 4 步：让您的 AI 安装服务器

使用仪表盘

支持的客户端

配置文件在哪里？

功能特性

先决条件

CLI 参考

CLI 选项

API 端点（仪表盘模式）

开发

项目结构

更新日志

v1.0.0 (通用重写版)

许可证

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API

Cursor (`~/.cursor/mcp.json`)

Claude Desktop (`claude_desktop_config.json`)

VS Code (`.vscode/mcp.json`)