MCPサーバーのインストールと管理のためのCLIツール。

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

使用法

CLIは現在、複数のインストール方法と自動検出をサポートしています:

シンプルなパッケージ名

スコープ付きパッケージ

カスタム引数用のフルコマンド

リモートURL(自動命名付き)

ツールは自動的に:

• 単純なパッケージ名を[[T0]に変換します。
• コマンドの完全な保存
• パッケージ名やURLからサーバー名を推測します(例:mcp.example.com→mcp-example-com)
• リモートサーバー向けのOAuth認証を処理

スーパーメモリープロジェクトのサポート

https://api.supermemory.ai/*にホストされているサーバーをインストールする際、プロジェクト名は--project経由で渡すことができます。これはヘッダーx-sm-project: を追加するための利便性エイリアスです。

ルール:

• https://api.supermemory.ai/*をターゲットにしたURLインストールにのみ適用されます。
• 値にはスペースが含まれてはならない。
• これらのURLに--projectを省略すると、プロンプトが表示されます。Enterを押すとdefaultを使用します。
• 値は--headerフラグの隣にヘッダーとして注入されます。

例:

Install MCP CLI

A CLI tool to install and manage MCP servers.

Installing MCPs is a huge pain, so I made a CLI tool to make it easier.

Usage

The CLI now supports multiple installation methods with automatic detection:

Simple package names

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

Scoped packages

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

Full commands (for custom arguments)

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

Remote URLs (with automatic naming)

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

The tool automatically:

• Converts simple package names to npx package-name
• Preserves full commands as-is
• Infers server names from package names or URLs (e.g., mcp.example.com → mcp-example-com)
• Handles OAuth authentication for remote servers

Supermemory project support

When installing a server hosted on https://api.supermemory.ai/*, you can pass a project name via --project. This is a convenience alias for adding the header x-sm-project: .

Rules:

• Only applies to URL installs targeting https://api.supermemory.ai/*.
• Values must not contain spaces.
• If you omit --project for these URLs, you’ll be prompted. Pressing Enter uses default.
• The value is injected as a header alongside any --header flags.

Examples:

# 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 users: the generated config will include --header "x-sm-project: " in the args array when installing Supermemory URLs.

Headers Support

You can pass headers for authentication or other purposes using the --header flag:

# 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 Authentication for Remote Servers

When installing remote servers (URLs), the CLI will ask if the server uses OAuth authentication:

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

You can bypass this prompt using the --oauth flag:

# 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

If you answer yes, the authentication flow:

• Runs automatically before installation
• Handles OAuth flows seamlessly in the background