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

``bash


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

`bash
npx init-mcp [options]
`

$3

The source can be:
- Local file path: ~/.mcp.json, ./config.json, /path/to/config.json
- URL: https://gist.githubusercontent.com/.../raw/.mcp.json

$3

`bash


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 | -s | Source config (file path or URL) |
| --target | -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