Multiverse MCP 服务器

一个中间件服务器，它允许多个隔离的相同 MCP 服务器实例在具有唯一命名空间和配置的情况下独立共存。

Multiverse MCP 服务器创建隔离的操作空间，相同的 MCP 服务器可以在其中同时运行而不会发生冲突。每个“宇宙”都维护着自己的配置、文件系统访问和函数命名，使开发人员能够运行同一服务器类型的多个实例，同时保持不同上下文或项目之间的完全隔离。

主要特性

运行多个实例

独立且同时运行同一 MCP 服务器类型的多个实例。每个实例都在其自己的隔离宇宙中运行，并具有单独的配置。这支持以下场景：

• 指向不同数据库的多个 MySQL 服务器 mcp-server-mysql
• 具有不同个人访问令牌的多个 Git 服务器 mcp-server-git
• 访问不同根路径的多个文件系统服务器 mcp-server-filesystem

自动服务器重启

在开发期间注册具有文件监视功能的 MCP 服务器。启用后，服务器会自动检测指定目录中的更改并执行优雅重启，从而使开发和测试无缝衔接。

基于 JSON 的配置系统

使用简单而灵活的 JSON 配置格式定义您的 multiverse 设置。每个服务器实例都可以配置自己的：

• 命令和参数
• 环境变量
• 路径解析规则
• 文件监视设置

安装

首先，请确保您已下载并安装了 Claude Desktop app 并且您已安装 npm。

接下来，将此条目添加到您的 claude_desktop_config.json 中

• 在 Mac 上，位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json
• 在 Windows 上，位于 C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json

现在添加您想要运行的 multiverse 服务器的数量。例如，如果您想运行两个 mcp-server-multiverse 实例，一个用于您的工作，一个用于您的副项目，您可以添加以下配置：

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

此配置允许 Claude Desktop 在您启动应用程序时自动启动 mcp-server-multiverse 实例。

配置示例

创建两个具有不同数据库的隔离的 mcp-server-mysql 实例

您的 job-multiverse.json 文件

{
  "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": "my-job-db"
      }
    }
  ]
}

您的 side-project-multiverse.json 文件

{
  "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"
      }
    }
  ]
}

创建一个隔离的 mcp-server-filesystem 实例

• mcp-server-filesystem 的函数将以 side-project 前缀公开，例如 side-project_read_file、side-project_write_file。
• 可以使用 pathResolution 配置从客户端（例如 Claude Desktop）隐藏根路径。

请注意，pathResolution 是可选的，仅当您想从客户端隐藏根路径时才需要。

您的 multiverse.json 文件

{
  "serverName": "MySideProject",
  "functionsPrefix": "side-project",
  "servers": [
    {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem@latest",
        "/full/path/to/side-project"
      ],
      "pathResolution": {
        "root": "/full/path/to/side-project",
        "applyTo": [
          "path",
          "paths"
        ]
      }
    }
  ]
}

文件更改时自动服务器重启，使用 fileWatch

您的 multiverse.json 文件

{
  "serverName": "MySideProject",
  "functionsPrefix": "side-project",
  "servers": [
    {
      "command": "node",
      "args": [
        "/my-own/mcp-server/i-m-working-on/build/index.js"
      ],
      "fileWatch": {
        "enabled": true,
        "path": "/my-own/mcp-server/i-m-working-on/build/"
      }
    }
  ]
}

使用 hideFunctions 选项隐藏特定函数

您可以使用 hideFunctions 数组有选择地隐藏包装服务器中的特定函数。当您想使用服务器但限制对某些可能危险或不必要的函数的访问时，这非常有用。

hideFunctions 数组接受应从包装服务器隐藏的函数名称列表。隐藏函数后：

• 它不会在主 MCP 服务器上注册
• 它对客户端（例如 Claude Desktop）不可用
• 它不会出现在可用函数列表中

此功能对于以下情况特别有用：

• 限制对潜在危险函数的访问（例如，GitHub 中的 delete_repository）
• 通过隐藏很少使用的函数来简化界面
• 为不同的服务器实例创建不同的权限级别

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

在此示例中，GitHub 服务器将正常启动，但函数 create_repository、delete_repository 和 create_issue 将被隐藏且对客户端不可用。

使用 enabled 标志禁用特定服务器

您可以通过将 enabled 标志设置为 false，有选择地禁用配置中的特定服务器，而无需从 JSON 文件中删除它们。这对于在开发或测试期间临时禁用服务器非常有用。

{
  "serverName": "MySideProject",
  "functionsPrefix": "side-project",
  "servers": [
    {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem@latest",
        "/full/path/to/side-project"
      ],
      "hideFunctions": [ "write_file" ]
    },
    {
      "enabled": false,
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github@latest"
      ]
    }
  ]
}

在此示例中，第一个服务器（文件系统）将启动，但函数 write_file 已被隐藏，第二个服务器 (GitHub) 已被禁用，不会启动。

multiverse.json 文件的完整示例

此示例演示如何创建具有不同服务器类型多个实例的 multiverse 服务器。

请注意，pathResolution 是可选的，仅当您想从客户端隐藏根路径时才需要。

{
  "serverName": "HugeProjectWithALotOfResources",
  "functionsPrefix": "huge-project",
  "servers": [
    {
      "command": "node",
      "args": [
        "/my-own/mcp-server/i-m-working-on/build/index.js"
      ],
      "fileWatch": {
        "enabled": true,
        "path": "/my-own/mcp-server/i-m-working-on/build/"
      }
    },
    {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem@latest",
        "/full/path/to/huge-project"
      ],
      "pathResolution": {
        "root": "/full/path/to/huge-project",
        "applyTo": [
          "path",
          "paths"
        ]
      }
    },
    {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github@latest"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    },
    {
      "command": "uvx",
      "args": [
        "mcp-server-git",
        "--repository",
        "/full/path/to/huge-project"
      ],
      "pathResolution": {
        "root": "/full/path/to/huge-project",
        "applyTo": [
          "repo_path"
        ]
      }
    }
  ]
}

待办事项

• [ ] 添加对 Prompts 的支持
• [ ] 添加对 Resources 的支持
• [ ] 添加一个用于管理 multiverse 服务器的 GUI

验证平台

• [x] Windows
• [ ] macOS
• [ ] Linux

许可证

MIT