使用说明

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

Install and configure MCP servers across all major AI clients with one command.

🚀 新功能：通用MCP安装程序v1.0.0 --完全重写 cursor-mcp-installer。现在支持 6个AI客户端 （克劳德桌面、光标、VS代码、OpenClaw、克劳德代码、ChatGPT）， 交叉平台的 （macOS、Windows、Linux），真实 MCP握手验证和a 品牌网络仪表板已升级至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/mcp.json`)

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

克劳德桌面(`claude_desktop_config.json`)

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

VS代码(`.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握手验证服务器并返回结果

使用仪表板

启动可视化界面：

npx universal-mcp-installer --ui

这将在浏览器中打开web界面 http://localhost:3939:

1.系统面板 --顶部会自动检测你的操作系统和所有可用的运行时（Node、npm、uvx、Python、git），这样你就可以一目了然地看到你的机器上有什么可用的。

2.人工智能客户端 --每个检测到的客户端都会收到一张卡，显示其名称、配置文件路径以及已配置的MCP服务器数量。使用每张卡上的切换开关将其包含在下一次安装中或从中排除。未安装的客户端显示为灰色。

3.安装 --键入包名（npm包、git URL或本地路径），从下拉列表中选择一种方法(Auto / npm / uvx / git / local)，然后撞上果岭安装按钮。安装程序解析包，将配置写入每个切换的客户端，并通过MCP握手进行验证。

4.进展与成果 --实时时间线显示了每个步骤（解析、编写配置、验证），并通过WebSocket实时更新状态。一旦完成，健康报告网格将显示每个客户端的通过/失败情况，包括工具计数、延迟和任何失败的恢复提示。

支持的客户

客户端	配置密钥	平台
克劳德桌面版	`mcpServers`	macOS、Windows、Linux
光标	`mcpServers`	macOS、Windows、Linux
VS代码（副本）	`servers`	全部（工作空间级别）
OpenClaw/NomeClaw	`mcp.servers`	macOS、Linux
克劳德代码	`mcpServers`	macOS、Windows、Linux
ChatGPT桌面	HTTP网桥	全部（通过本地HTTP代理）

配置文件在哪里？

客户端	macOS	Windows	Linux
克劳德桌面版	`~/Library/Application Support/Claude/claude_desktop_config.json`	`%APPDATA%\Claude\claude_desktop_config.json`	`~/.config/Claude/claude_desktop_config.json`
光标	`~/.cursor/mcp.json`	`%USERPROFILE%\.cursor\mcp.json`	`~/.cursor/mcp.json`
VS Code	`.vscode/mcp.json` （工作空间）	`.vscode/mcp.json` （工作空间）	`.vscode/mcp.json` （工作空间）
开爪	`~/.openclaw/openclaw.json`	-	`~/.openclaw/openclaw.json`
克劳德代码	`.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（macOS）、systemd（Linux）或任务计划程序（Windows）配置
Web仪表板：带有实时WebSocket进度更新的品牌React UI

先决条件

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

可选：

紫外线/紫外线适用于Python MCP服务器
版本控制系统用于从存储库安装

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握手验证（无）
通过平台特定的配置路径添加了跨平台支持
添加CLI detect, install, validate 命令
添加了React+Tailwind+WebSocket的web仪表板
添加了50多个真实测试（ echo "No tests specified")
添加了已知问题错误恢复数据库
添加了服务模板生成（launchd、systemd、任务调度器）
替换 rimraf/spawn-rx 内置Node
固定的： require.resolve ESM背景下
固定的： console.error/console.warn 破坏标准io JSON-RPC流
完整的TypeScript源代码（仅由JS编译）

许可证

麻省理工学院

使用说明

快速入门指南

步骤1：安装MCP服务器（一个命令）

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

光标(~/.cursor/mcp.json)

克劳德桌面(claude_desktop_config.json)

VS代码(.vscode/mcp.json)

步骤3：重新启动AI客户端

步骤4：让你的AI安装服务器

使用仪表板

支持的客户

配置文件在哪里？

特性

先决条件

CLI 参考

CLI选项

API端点（仪表板模式）

发展

项目结构

更新日志

v1.0.0（通用重写）

许可证

相关 MCP

AKShare One MCP 股市数据服务

实时网络搜索服务

浏览器自动化MCP服务器

arXiv 论文检索 MCP 服务器

移动自动化MCP服务器

AI持久记忆服务器

光标(`~/.cursor/mcp.json`)

克劳德桌面(`claude_desktop_config.json`)

VS代码(`.vscode/mcp.json`)