Lukynnnn/mcp-manager-universal

MCP Manager Universal

A universal MCP (Model Context Protocol) server that manages all your other MCP servers across multiple AI coding harnesses.

What it does

• 23 tools across 6 categories
• 7 harnesses supported: OpenCode, Claude Desktop, Cursor, Windsurf, Cline, Zed, Continue.dev
• Auto-detection of installed harnesses
• Format conversion between harnesses
• Encrypted token storage (Fernet AES-128-CBC)
• Health checks (STDIO, Docker, HTTP)
• Built-in catalog of 20 popular MCP servers

Installation

pip install mcp-manager-universal

Quick Start

Run locally

python -m src

Run with Docker

docker build -t mcp-manager .
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | docker run -i --rm mcp-manager

Add to OpenCode

{
  "mcp": {
    "mcp-manager": {
      "type": "local",
      "command": "python",
      "args": ["-m", "src"],
      "cwd": "/path/to/mcp-manager"
    }
  }
}

Tools Reference

Category	Tool	Description
Config	list_configs	List all MCP configurations
Config	read_config	Read a specific config file
Config	write_config	Write/update a config
Servers	list_servers	List all configured servers
Servers	add_server	Add a new server
Servers	remove_server	Remove a server
Servers	get_server	Get server details
Catalog	list_catalog	List available servers
Catalog	install_server	Install from catalog
Tokens	set_token	Store an encrypted token
Tokens	get_token	Retrieve a token
Tokens	rotate_token	Rotate a token
Tokens	delete_token	Delete a token
Health	health_check	Check server health
Health	health_check_all	Check all servers
Sync	sync_configs	Sync between harnesses
Sync	export_config	Export to another format
Search	search_servers	Search catalog
Search	search_installed	Search installed servers
Docker	docker_build	Build Docker image
Docker	docker_run	Run Docker container
Docker	docker_test	Test Docker STDIO
Info	server_info	Get server info

Links

• GitHub: kobramantra-debug/mcp-manager-mcp-manage
• PyPI: mcp-manager-universal
• License: MIT

Security

• All tokens encrypted with Fernet AES-128-CBC
• PBKDF2 key derivation (480k iterations)
• Master password via environment variable
• Token rotation with history
• No hardcoded secrets