neon-solutions/add-mcp

What it solves

add-mcp simplifies the process of adding Model Context Protocol (MCP) servers to various AI coding agents. Instead of manually editing complex configuration files for different tools, users can install servers via a single command across multiple supported agents simultaneously.

How it works

The tool acts as a configuration manager that maps a single installation command to the specific config formats and file paths required by different AI agents. It supports three transport types: HTTP, SSE, and stdio.

Key functionalities include:

• Installation: Adds servers via remote URLs or package names.
• Registry Integration: Allows users to find and install servers from a curated registry.
• Smart Detection: Automatically identifies which agents are installed on the user's system to suggest targets.
• Scope Management: Supports both project-level (shared with teams via version control) and global-level (user-wide) installations.
• Capability Mapping: Handles agent-specific features like request timeouts, OAuth scopes, and tool auto-approval, dropping unsupported fields with a warning for specific agents.

Who it’s for

Developers using AI coding assistants (such as Cursor, Claude Code, VS Code, or Zed) who want to extend their agents' capabilities with MCP servers without manually managing JSON or TOML configuration files.

Highlights

• Broad Compatibility: Supports over 20 coding agents, including Claude Code, Cursor, Codex, and Windsurf.
• Unified CLI: Single command interface to add, remove, list, sync, and search for MCP servers.
• Programmatic API: Provides an upsertServer function for integration into other CLI tools.
• Flexible Configuration: Supports environment variables, custom headers, and auto-approval of tool calls for supported agents.