             _   _ _   _ _____     _______ ____  ____    _    _     
            | | | | \ | |_ _\ \   / / ____|  _ \/ ___|  / \  | |    
            | | | |  \| || | \ \ / /|  _| | |_) \___ \ / _ \ | |    
            | |_| | |\  || |  \ 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 サーバーをインストールする (1 コマンド)

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 が呼び出せる 3 つのツールを提供します:

ツール	説明
`detect_system`	OS、アーキテクチャ、利用可能なランタイム、検出された AI クライアントを返します
`install_mcp_server`	パッケージ名、Git URL、またはローカルパスから選択したクライアントにサーバーをインストールします
`validate_mcp_server`	MCP ハンドシェイクを介してサーバーを検証し、結果を返します

Related MCP server: MCP Server Template for Cursor IDE

ダッシュボードの使用方法

視覚的なインターフェースを起動します:

npx universal-mcp-installer --ui

これにより、ブラウザの http://localhost:3939 で Web インターフェースが開きます:

1. システムパネル — 上部のセクションでは、OS と利用可能なすべてのランタイム (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 ダッシュボード: リアルタイムの WebSocket 進捗更新を備えた React UI

前提条件

Node.js v18 以降
対応する AI クライアントが少なくとも 1 つインストールされていること

オプション:

Python MCP サーバー用の uv/uvx
リポジトリからインストールするための 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 (Universal Rewrite)

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, タスクスケジューラ)
rimraf/spawn-rx を Node の組み込み機能に置き換え
修正: ESM コンテキストでの require.resolve
修正: console.error/console.warn が stdio JSON-RPC ストリームを破損させる問題
完全な TypeScript ソース (以前はコンパイルされた JS のみのアーティファクト)

ライセンス

MIT

Cursor MCP Installer

クイックスタートガイド

ステップ 1: MCP サーバーをインストールする (1 コマンド)

ステップ 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 (Universal Rewrite)

ライセンス

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API

クイックスタートガイド

ステップ 1: MCP サーバーをインストールする (1 コマンド)

ステップ 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 (Universal Rewrite)

ライセンス

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`)