一个用于安装和管理MCP服务器的CLI工具。

安装MCP非常麻烦，所以我做了一个CLI工具来简化操作。

用途

CLI现在支持多种安装方法，并支持自动检测：

简单的包名

有范围的包裹

完整命令（用于自定义参数）

远程网址（带自动命名）

该工具会自动：

• 将简单的包名转换为npx package-name
• 保留完整命令原样
• 从包名或URL推断服务器名称（例如，mcp.example.com → mcp-example-com）
• 处理远程服务器的OAuth认证

超级记忆项目支持

安装托管在 https://api.supermemory.ai/* 的服务器时，可以通过 --project 传递项目名称。这是一个方便的别名，用于添加头部 x-sm-project: 。

规则：

• 仅适用于针对https://api.supermemory.ai/*的URL安装。
• 值不得包含空格。
• 如果你省略了这些URL的--project，你将被提示。按回车键使用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