MCPgee
MCPgee
MCPgeeMCPgee

Multiverse

v1.0.0โ€ขDeveloper Toolsโ€ขstable

๐Ÿ“‡ ๐Ÿ  ๐Ÿ› ๏ธ - A middleware server that enables multiple isolated instances of the same MCP servers to coexist independently with unique namespaces and configurations.

multiversemcpai-integration
Share:
77
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Multiverse?

Multiverse is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐Ÿ“‡ ๐Ÿ  ๐Ÿ› ๏ธ - a middleware server that enables multiple isolated instances of the same mcp servers to coexist independently with unique namespaces and configurations.

๐Ÿ“‡ ๐Ÿ  ๐Ÿ› ๏ธ - A middleware server that enables multiple isolated instances of the same MCP servers to coexist independently with unique namespaces and configurations.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ๐Ÿ“‡ ๐Ÿ  ๐Ÿ› ๏ธ - A middleware server that enables multiple isolated

Use Cases

Run multiple isolated instances of the same MCP servers independently.
Manage unique namespaces and configurations for each server instance.
lamemind

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 5, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx multiverse

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Multiverse

Multiverse is a middleware MCP server that lets you run multiple isolated instances of the same MCP server type simultaneously, each with its own namespace, configuration, environment variables, and filesystem access. It solves the common problem of needing, for example, two separate MySQL MCP servers pointing to different databases, or two filesystem servers rooted at different paths, without tool name collisions. Each 'universe' prefixes its exposed tools (e.g. job_read_file vs side-project_read_file) so Claude and other MCP clients can address them independently. It also supports automatic server restart on file changes, making it useful during active MCP server development.

Prerequisites

  • Node.js 18 or later installed (npx must be available)
  • An MCP client such as Claude Desktop or any MCP-compatible tool
  • The inner MCP servers you want to multiplex already installed or accessible via npx
  • A JSON configuration file for each 'universe' you want to run
1

Create a universe configuration file

Write a JSON file that describes the server(s) to run inside this universe. Set serverName for identification, functionsPrefix for namespacing tool names, and list the inner servers under the servers array with their command, args, and env.

{
  "serverName": "JobMultiverse",
  "functionsPrefix": "job",
  "servers": [
    {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "job-db"
      }
    }
  ]
}
2

Create a second universe configuration file

Create an equivalent file for the second instance, pointing to a different database or path. Use a different functionsPrefix so tool names do not clash.

{
  "serverName": "SideProjectMultiverse",
  "functionsPrefix": "side-project",
  "servers": [
    {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "side-project-db"
      }
    }
  ]
}
3

Add both universes to claude_desktop_config.json

Register each universe as a separate MCP server entry in your Claude Desktop configuration. Each entry runs the @lamemind/mcp-server-multiverse package and passes the path to its JSON config file.

{
  "mcpServers": {
    "job-multiverse": {
      "command": "npx",
      "args": ["-y", "@lamemind/mcp-server-multiverse@latest", "/path/to/job-multiverse.json"]
    },
    "side-project-multiverse": {
      "command": "npx",
      "args": ["-y", "@lamemind/mcp-server-multiverse@latest", "/path/to/side-project-multiverse.json"]
    }
  }
}
4

Optionally hide dangerous functions

Use the hideFunctions array inside a server block to prevent specific tools from being registered. This is useful to restrict access to destructive operations like deleting repositories.

{
  "serverName": "GitHubSafe",
  "functionsPrefix": "github",
  "servers": [
    {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github@latest"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-token>" },
      "hideFunctions": ["delete_repository"]
    }
  ]
}
5

Enable auto-restart during development

When developing your own MCP server, add a fileWatch block to the server entry. Multiverse will watch the specified directory and gracefully restart the inner server whenever files change.

{
  "serverName": "MyDevServer",
  "functionsPrefix": "dev",
  "servers": [
    {
      "command": "node",
      "args": ["/my-mcp-server/build/index.js"],
      "fileWatch": {
        "enabled": true,
        "path": "/my-mcp-server/build/"
      }
    }
  ]
}
6

Restart Claude Desktop and verify

Quit and reopen Claude Desktop. The namespaced tools from each universe should appear in the tool list. Test by asking Claude to use a prefixed tool, such as 'job_read_file' or 'side-project_write_file'.

Multiverse Examples

Client configuration

Running two isolated MySQL MCP server instances via Multiverse, each pointing to a different database.

{
  "mcpServers": {
    "job-multiverse": {
      "command": "npx",
      "args": ["-y", "@lamemind/mcp-server-multiverse@latest", "/Users/you/job-multiverse.json"]
    },
    "side-project-multiverse": {
      "command": "npx",
      "args": ["-y", "@lamemind/mcp-server-multiverse@latest", "/Users/you/side-project-multiverse.json"]
    }
  }
}

Prompts to try

Once configured, you can address each universe's tools by their prefixed names.

- "Use job_read_file to read /data/report.csv from the job universe"
- "Use side-project_write_file to create a new config file in the side project"
- "List all tools available in the job-multiverse server"
- "Connect to the job MySQL database and show me the list of tables"

Troubleshooting Multiverse

Tool names collide or tools from the wrong universe are called

Ensure each universe JSON file has a unique functionsPrefix value. Tools are exposed as <prefix>_<original_tool_name>, so prefixes must differ across all universe entries.

Inner server fails to start or exits immediately

Test the inner server command directly in your terminal first (e.g. run npx -y @benborla29/mcp-server-mysql with the same env vars) to confirm it works standalone before wrapping it in Multiverse.

File watch does not trigger server restart

Verify the fileWatch.path points to the directory that actually changes on build. The path must exist when Multiverse starts; it watches for file changes within that directory recursively.

Frequently Asked Questions about Multiverse

What is Multiverse?

Multiverse is a Model Context Protocol (MCP) server that ๐Ÿ“‡ ๐Ÿ  ๐Ÿ› ๏ธ - a middleware server that enables multiple isolated instances of the same mcp servers to coexist independently with unique namespaces and configurations. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Multiverse?

Follow the installation instructions on the Multiverse GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Multiverse?

Multiverse works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Multiverse free to use?

Yes, Multiverse is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Multiverse Alternatives โ€” Similar Developer Tools Servers

Looking for alternatives to Multiverse? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

โ˜… 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

โ˜… 155.8k

Java ้ข่ฏ• & ๅŽ็ซฏ้€š็”จ้ข่ฏ•ๆŒ‡ๅ—๏ผŒ่ฆ†็›–่ฎก็ฎ—ๆœบๅŸบ็ก€ใ€ๆ•ฐๆฎๅบ“ใ€ๅˆ†ๅธƒๅผใ€้ซ˜ๅนถๅ‘ใ€็ณป็ปŸ่ฎพ่ฎกไธŽ AI ๅบ”็”จๅผ€ๅ‘

Gemini CLI

โ˜… 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

โ˜… 87.3k

โญ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

โ˜… 86.0k

Model Context Protocol Servers

CC Switch

โ˜… 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "multiverse": { "command": "npx", "args": ["-y", "multiverse"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use Multiverse?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides