Install MCP CLI

MCP CLI のインストール

MCP サーバーをインストール、管理する CLI ツールです。

MCP のインストールは非常に面倒なので、もっと簡単にできる CLI ツールを作りました。

使い方

CLI は自動検出により、複数のインストール方法に対応するようになりました。

シンプルなパッケージ名

npx install-mcp mcp-package-name --client claude-desktop

スコープ付きパッケージ

npx install-mcp @org/mcp-server --client claude-desktop

完全なコマンド（カスタム引数用）

npx install-mcp 'npx some-mcp-server --custom-args' --client claude-desktop

リモート URL（名前を自動設定）

npx install-mcp https://mcp.example.com/server --client claude-desktop

このツールは以下を自動で行います。

• シンプルなパッケージ名を npx package-name に変換します
• 完全なコマンドはそのまま保持します
• パッケージ名または URL からサーバー名を推測します（例：mcp.example.com → mcp-example-com）
• リモートサーバーの OAuth 認証を処理します

Supermemory プロジェクトのサポート

https://api.supermemory.ai/* でホストされているサーバーをインストールする際、--project を使ってプロジェクト名を指定できます。これは、x-sm-project: <value> ヘッダーを追加するための便利なエイリアスです。

ルール：

• https://api.supermemory.ai/* を対象とする URL インストールにのみ適用されます。
• 値にスペースを含めることはできません。
• これらの URL に対して --project を省略すると、入力を求められます。Enter キーを押すと default が使用されます。
• 値は、--header フラグとともにヘッダーとして挿入されます。

例：

# Explicit project
npx install-mcp https://api.supermemory.ai/servers/my-server \
  --client cursor \
  --project myproj

# Prompted for project (Enter defaults to "default")
npx install-mcp https://api.supermemory.ai/servers/my-server --client cursor

Warp ユーザーの場合：生成される設定では、Supermemory URL のインストール時に、args 配列に --header "x-sm-project: <value>" が含まれます。

ヘッダーのサポート

認証などの目的で、--header フラグを使ってヘッダーを渡せます。

# Single header
npx install-mcp https://api.example.com/mcp --client claude-desktop --header "Authorization: Bearer token123"

# Multiple headers
npx install-mcp https://api.example.com/mcp --client claude-desktop \
  --header "Authorization: Bearer token123" \
  --header "X-API-Key: secret-key"

リモートサーバーの OAuth 認証

リモートサーバー（URL）をインストールする際、CLI はサーバーが OAuth 認証を使用するかどうかを尋ねます。

npx install-mcp https://api.example.com/mcp --client claude-desktop
# Output: Does this server use OAuth authentication? (Y/n)

--oauth フラグを使うと、この確認を省略できます。

# Automatically run OAuth authentication
npx install-mcp https://api.example.com/mcp --client claude-desktop --oauth yes

# Skip OAuth authentication entirely
npx install-mcp https://api.example.com/mcp --client claude-desktop --oauth no

「はい」と答えると、認証フローは次のように動作します。

• インストール前に自動で実行されます
• OAuth フローをバックグラウンドでシームレスに処理します
• 認証状態はグローバルに共有されます。サーバーで一度認証すると、その認証はすべての MCP クライアントで自動的に利用できるようになります
• 異なるクライアントで同じサーバーを使う際に、再認証する必要はありません

# Output: Running authentication for https://api.example.com/mcp

認証に失敗すると、次のように表示されます。

Authentication failed. Use the client to authenticate.

サーバーが OAuth を使用しない場合（「いいえ」と答えた場合）、認証せずにインストールが進みます。

これにより、OAuth を必要としないサーバーへの柔軟性を保ちながら、リモートサーバーへの安全なアクセスを実現します。

対応クライアント

--client フラグで、インストール先の MCP クライアントを指定します。

• claude-desktop
• cline
• roo-cline
• windsurf
• witsy
• enconvo
• cursor
• vscode
• gemini-cli
• claude-code
• goose
• zed
• opencode
• warp（Warp のクラウドベースの設定にコピー／貼り付けする設定を出力します）
• codex（OpenAI の Codex CLI ツール）
• droid（Factory.AI の Droid CLI ツール）
• aider（AI ペアプログラミングツール）
• aider-desk（aider のデスクトップ版）

ライセンス

MIT