Multiverse MCP Server

Multiverse MCP Server

一个中间件服务，可让同一 MCP 服务的多个隔离实例通过独立的命名空间和配置共存。

Multiverse MCP Server 会创建隔离的运行空间，让相同的 MCP 服务可以同时运行而互不冲突。每个“宇宙”都有自己的配置、文件系统访问权限和函数命名方式，开发者可以运行多个相同类型的服务实例，同时确保不同上下文或项目之间完全隔离。

主要功能

运行多个实例

独立且同时运行多个相同类型的 MCP 服务实例。每个实例都在独立的宇宙中运行，拥有单独的配置。适用场景包括：

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

自动重启服务

在开发期间，通过文件监视功能注册 MCP 服务。启用后，服务会自动检测指定目录中的更改并执行平稳重启，让开发和测试更加顺畅。

基于 JSON 的配置系统

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

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

托管部署

可通过 Fronteir AI 使用托管部署。

安装

首先，确保已下载并安装 Claude 桌面应用，并且已安装 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 标志停用特定服务

你可以在配置中选择性地停用特定服务，而无需将其从 JSON 文件中移除，只需将 enabled 标志设为 false。在开发或测试期间临时停用服务时，这会很有用。

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

在此示例中，第一个服务（filesystem）会启动，但函数 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 服务的图形用户界面

已验证的平台

• Windows
• macOS
• Linux

许可证

MIT