init-mcp

Copy your MCP (Model Context Protocol) configuration to AI coding tools in one command.

MCP is an open protocol that lets AI assistants like Claude connect to external tools and data sources. This CLI helps you copy your MCP config to multiple AI coding tools at once.

Supported Tools

Tool	Target	Config Path
Claude Code	claude	.mcp.json
Cursor (project)	cursor	.cursor/mcp.json
Cursor (global)	cursor-global	~/.cursor/mcp.json
Windsurf	windsurf	~/.codeium/windsurf/mcp_config.json

Quick Start

# Copy from a local file
npx init-mcp ~/.mcp.json

# Copy to all supported tools
npx init-mcp ~/.mcp.json --target all

# Copy from a URL (e.g., GitHub Gist)
npx init-mcp https://gist.githubusercontent.com/user/id/raw/.mcp.json

Usage

npx init-mcp <source> [options]

Source

The source can be:

• Local file path: ~/.mcp.json, ./config.json, /path/to/config.json
• URL: https://gist.githubusercontent.com/.../raw/.mcp.json

Examples

# Copy your global config to current project
npx init-mcp ~/.mcp.json

# Copy to all tools at once
npx init-mcp ~/.mcp.json --target all

# Copy from a URL to Cursor
npx init-mcp https://example.com/mcp.json --target cursor

# Overwrite existing configs
npx init-mcp ~/.mcp.json --target all --force

Output Example

$ npx init-mcp ~/.mcp.json --target all

Reading config from ~/.mcp.json...

✓ Created .mcp.json
✓ Created .cursor/mcp.json
⚠ Skipped ~/.cursor/mcp.json (already exists, use --force to overwrite)
⊘ Skipped Windsurf (~/.codeium/windsurf does not exist)

Done! Created 2 config files.

Options

Option	Short	Description
--source <path>	-s	Source config (file path or URL)
--target <name>	-t	Target tool: claude, cursor, cursor-global, windsurf, all
--force	-f	Overwrite existing config files
--help	-h	Show help
--version	-v	Show version

Requirements

• Node.js 18 or higher

License

MIT