Инструмент CLI для установки и управления MCP-серверами.

Установка MCP — это огромная морока, поэтому я сделал инструмент CLI, чтобы упростить задачу.

Использование

CLI теперь поддерживает несколько методов установки с автоматическим обнаружением:

Простые названия пакетов

Посылки с ограничением

Полные команды (для пользовательских аргументов)

Удалённые URL (с автоматическим именованием)

Инструмент автоматически:

• Преобразует простые имена пакетов в npx package-name
• Сохраняет полные команды в том виде
• Выводит имена серверов из имён пакетов или URL (например, mcp.example.com → mcp-example-com)
• Обрабатывает аутентификацию OAuth для удалённых серверов

Поддержка проекта Supermemory

При установке сервера, размещённого на https://api.supermemory.ai/*, можно передать имя проекта через --project. Это удобный псевдоним для добавления заголовка x-sm-project: .

Правила:

• Применяется только к установкам URL, нацеленных на https://api.supermemory.ai/*.
• Значения не должны содержать пробелы.
• Если вы пропустите --project для этих URL, вам будет предложено. Нажатие 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