Overview: Multiverse MCP Server

Title

Multiverse MCP Server – A middleware server that enables multiple isolated instances of the same MCP servers to coexist independently with unique namespaces and configurations.

How to Use

1. Installation:

   • Download and install the Claude Desktop app.
   • Ensure npm is installed.
   • Modify claude_desktop_config.json (located in OS-specific paths) to include your desired MCP server instances.

2. Configuration:

   • Define server instances in JSON files (e.g., job-multiverse.json, side-project-multiverse.json).
   • Specify commands, arguments, environment variables, and other settings per instance.

3. Execution:

   • The Multiverse MCP Server automatically starts configured instances when the Claude Desktop app launches.

Key Features

• Run Multiple Instances:
  • Isolated environments for identical MCP servers (e.g., MySQL, Git, filesystem) with separate configurations.
• Automatic Server Restart:
  • Watches for file changes during development and restarts servers gracefully.
• JSON-Based Configuration:
  • Flexible setup for commands, environment variables, path resolution, and file watching.
• Function Control:
  • Hide specific functions (hideFunctions) or disable entire servers (enabled flag) for security or simplicity.

Use Cases

• Development & Testing:
  • Run multiple MySQL servers with different databases or Git servers with unique tokens.
• Project Isolation:
  • Separate filesystem access for different projects using mcp-server-filesystem.
• Security & Permissions:
  • Restrict access to sensitive functions (e.g., GitHub’s delete_repository).
• Temporary Disabling:
  • Disable non-critical servers without removing them from the configuration.

Example Scenarios

• Two MySQL instances (job-db and side-project-db) running simultaneously.
• A filesystem server with hidden root paths for client-side safety.
• A GitHub server with restricted functions to prevent accidental repository deletion.

The Multiverse MCP Server simplifies managing multiple MCP instances while ensuring isolation, security, and flexibility.