mcp-config-converter
v1.0.0
Published
Convert MCP configurations between different AI code editors
Maintainers
Readme
MCP Config Converter
What is MCP?
Model Context Protocol (MCP) is an open standard that enables AI assistants to connect with external tools and data sources. Many AI-powered code editors now support MCP, but each has its own configuration format.
MCP Config Converter solves this problem by letting you convert your MCP server configurations between different editors instantly.
Supported Editors
| Editor | Config File | Documentation |
|--------|-------------|---------------|
| Claude Desktop | claude_desktop_config.json | Docs |
| VS Code (GitHub Copilot) | .vscode/mcp.json | Docs |
| Cursor | .cursor/mcp.json | Docs |
| OpenCode | opencode.json | Docs |
| Gemini CLI | settings.json | Docs |
| LM Studio | mcp.json | Docs |
| Antigravity | mcp_config.json | Docs |
Features
- 🔄 Bidirectional Conversion - Convert between any supported editor formats
- 🔍 Auto-Detection - Automatically detects the source format from pasted config
- 📋 One-Click Copy - Copy converted config to clipboard instantly
- 📝 Example Configs - Load example configurations for each editor
- 🌐 Multi-Language - English and Korean interface
- 🎨 Glassmorphism UI - Modern, beautiful glass-effect design
- 📱 Responsive - Works on desktop and mobile devices
- ⚡ Fast & Offline - All conversions happen in your browser
Quick Start
Option 1: Use Online
Visit mcpuniv.lovable.app - no installation required!
Option 2: Run Locally
# Clone the repository
git clone https://github.com/your-username/mcp-config-converter.git
cd mcp-config-converter
# Install dependencies
npm install
# Start development server
npm run devUsage
- Select Source Format - Choose the editor format you're converting from
- Select Target Format - Choose the editor format you're converting to
- Paste Configuration - Paste your MCP config in the input panel
- Convert - Click the "Convert" button
- Copy Result - Copy the converted config and use it in your target editor
CLI Tool
The project includes a CLI tool mcpconv to automatically sync configurations between editors.
Installation
# Install globally
npm install -g mcp-config-converter
# Or run directly with npx
npx mcp-config-converter [command]Commands
sync
Detects an MCP config file in the current directory and syncs it to installed editors.
# Sync to all installed editors
mcpconv sync
# Sync to specific editors
mcpconv sync --target claude-desktop,cursor
# Dry run (preview changes)
mcpconv sync --dry-runOptions:
-t, --target <editors...>: Target specific editors (comma-separated)-d, --dry-run: Show what would be done without making changes-v, --verbose: Show detailed output-f, --force: Overwrite without confirmation
list
List all installed editors detected on your system and their config file paths.
mcpconv listeditors
List all supported editors and their default configuration paths.
mcpconv editorsExample
Claude Desktop → VS Code
Input (Claude Desktop):
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
}
}
}Output (VS Code):
{
"servers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
}
}
}Format Differences
Each editor has unique configuration features:
| Feature | Claude | VS Code | Cursor | OpenCode | Gemini CLI | LM Studio |
|---------|--------|---------|--------|----------|------------|-----------|
| Root Key | mcpServers | servers | mcpServers | mcp | mcpServers | mcpServers |
| Type Field | ❌ | ✅ | ❌ | ✅ (local/remote) | ❌ | ❌ |
| URL Support | ✅ | ✅ | ✅ | ✅ | ✅ (httpUrl) | ✅ |
| Headers | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Timeout | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
| Command Array | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
Tech Stack
- Framework: React 18 + TypeScript
- Styling: Tailwind CSS + shadcn/ui
- i18n: react-i18next
- Build: Vite
- Deployment: Lovable
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is open source and available under the MIT License.
Acknowledgments
- Model Context Protocol by Anthropic
- All the AI code editor teams for building MCP support
