🧙‍♂️ mcpenetes

"One CLI to rule them all, one CLI to find them, one CLI to bring them all, and in the configurations bind them."

🌟 What is mcpenetes?

mcpenetes is a magical CLI tool that helps you manage multiple Model Context Protocol (MCP) server configurations with ease! If you're tired of manually editing config files for different MCP-compatible clients whenever you want to switch servers, mcpenetes is here to save your day.

Think of mcpenetes as your friendly neighborhood wizard who can:

• 🔍 Search for available MCP servers from configured registries
• 🔄 Switch between different MCP server configurations
• 🧠 Apply configurations across all your MCP clients automatically
• 💾 Backup your configurations before making any changes
• 🛡️ Restore configurations if something goes wrong

🚀 Installation

From Source

git clone https://github.com/tuannvm/mcpenetes.git
cd mcpenetes
make build
# The binary will be available at ./bin/mcpenetes

Using Go

go install github.com/tuannvm/mcpenetes@latest

🏄‍♂️ Quick Start

1. Search for available MCP servers:

mcpenetes search

1. Apply selected configuration to all your clients:

mcpenetes apply

That's it! Your MCP configurations are now synced across all clients. Magic! ✨

📚 Usage Guide

🛠️ Available Commands

search         Interactive fuzzy search for MCP versions and apply them
apply          Applies MCP configuration to all clients
load           Load MCP server configuration from clipboard
restore        Restores client configurations from the latest backups

📋 Searching for MCP Servers

The search command lets you interactively find and select MCP servers from configured registries. It will present you with a list of available servers that you can select from.

mcpenetes search

You can also directly specify a server ID:

mcpenetes search claude-3-opus-0403

By default, search results are cached to improve performance. Use the --refresh flag to force a refresh:

mcpenetes search --refresh

📥 Loading Configuration from Clipboard

If you've copied an MCP configuration to your clipboard, you can load it directly:

mcpenetes load

🗑️ Removing Resources

To remove a registry:

mcpenetes remove registry my-registry

⏪ Restoring Configurations

If something goes wrong, you can restore your clients' configurations from backups:

mcpenetes restore

🧩 Supported Clients

mcpenetes automatically detects and configures the following MCP-compatible clients:

• Claude Desktop
• Windsurf
• Cursor
• Visual Studio Code extensions

📁 Configuration Files

mcpenetes uses the following configuration files:

• ~/.config/mcpenetes/config.yaml: Stores global configuration, including registered registries and selected MCP servers
• ~/.config/mcpenetes/mcp.json: Stores the MCP server configurations
• ~/.config/mcpenetes/cache/: Caches registry responses for faster access

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📜 License

Licensed under the MIT License. See the LICENSE file for details.

🌐 Related Projects

• mcp-trino: Trino MCP server implementation

Made with ❤️ by humans (and occasionally with the help of AI)