开源MCP工具：npx add-mcp

Install an MCP Server

Install an MCP server by remote URL or package name:

npx add-mcp url | package name [options]

Example installing the Context7 remote MCP server:

npx add-mcp https://mcp.context7.com/mcp

You can add env variables and arguments (stdio) and headers (remote) to the server config using the --env, --args and --header options. With ${VAR} placeholders, interactive installs prompt for each variable (omit skipped optional keys so empty strings are not written to config).

Installation Scope

Non-interactive installation to all detected agents in the project directory

npx add-mcp https://mcp.example.com/mcp -y

Non-interactive installation to the global Claude Code config

npx add-mcp https://mcp.example.com/mcp -g -a claude-code -y

Install for Cursor and Claude Code

npx add-mcp https://mcp.example.com/mcp -a cursor -a claude-code

Install with custom server name

npx add-mcp @modelcontextprotocol/server-postgres --name postgres

Install to all supported agents

npx add-mcp mcp-server-github --all

Install to all agents, globally, without prompts

npx add-mcp mcp-server-github --all -g -y

Install a found server globally to a specific agent without prompts

npx add-mcp find neon -a claude-code -g -y

Install to all agents and add generated project configs to .gitignore

npx add-mcp find github --all --gitignore ```

Usage Examples

```bash

Usage Examples

```bash

Local stdio server with environment variables (repeatable)

npx add-mcp @modelcontextprotocol/server-filesystem --env "API_KEY=secret" --env "DATABASE_URL=postgres://localhost/app"

Add generated config files to .gitignore

npx add-mcp https://mcp.example.com/mcp -a cursor -y --gitignore ```

Options

Options

Transport for find/search is inferred from registry metadata. The CLI prefers HTTP remotes when available and only falls back to SSE when HTTP is not available for the selected install context.

When a server offers both remote and stdio package options, interactive mode lets you choose one (remote is the default). With -y, it auto-selects remote.

If a selected remote server defines URL variables or header inputs:

• required values must be provided
• optional values can be skipped with Enter
• with -y, placeholders are inserted (for example <your-header-value-here>)

Configuring Registries for Find / Search

The first time you run find or search, the CLI prompts you to choose which registries to enable. Your selection is saved to ~/.config/add-mcp/config.json (respects XDG_CONFIG_HOME) and reused on every subsequent search.

If you run with -y before this one-time registry setup is completed, the CLI exits with guidance to rerun without --yes.

List global server configs

npx add-mcp list -g

Remove from global configs for a specific agent

npx add-mcp remove neon -g -a cursor -y ```

Sync project-level configs (interactive confirmation)

npx add-mcp sync

Sync global configs

npx add-mcp sync -g -y ```

unify is an alias for sync.

Programmatic API

import {
  detectProjectAgents,
  detectGlobalAgents,
  upsertServer,
  removeServer,
  listInstalledServers,
} from "add-mcp";

const project = detectProjectAgents("/path/to/project");
const global = await detectGlobalAgents();

// Remote server
upsertServer(
  "claude-code",
  "example",
  { type: "http", url: "https://mcp.example.com/api" },
  { local: true, cwd: "/path/to/project" },
);

// Stdio (npm package)
upsertServer("claude-code", "postgres", {
  command: "npx",
  args: ["-y", "@modelcontextprotocol/server-postgres"],
});

const projectServers = await listInstalledServers({
  cwd: "/path/to/project",
});
const globalServers = await listInstalledServers({ global: true });

removeServer("claude-code", "example", {
  local: true,
  cwd: "/path/to/project",
});

upsertServer and removeServer return { success, path, error? } rather than throwing.

npm package (runs via npx)

npx add-mcp @modelcontextprotocol/server-postgres

Troubleshooting