Multiverse MCP Server

Multiverse MCP Server

site icon
2025.02.25 45
TypeScript多实例管理服务器隔离开发工具开发效率
Multiverse MCP Server 是一个中间件服务器,允许多个相同类型的 MCP 服务器实例在独立的命名空间和配置下共存运行。它创建了隔离的操作空间,使得相同的 MCP 服务器可以同时运行而不会产生冲突。每个"宇宙"维护自己的配置、文件系统访问和函数命名,使开发者能够在不同的上下文或项目中运行多个相同类型的服务器实例,同时保持完全分离。
View on GitHub

Overview

基本能力

产品定位

Multiverse MCP Server 是一个中间件服务器,旨在提供多实例隔离运行的解决方案,适用于需要同时运行多个相同类型 MCP 服务器实例的场景。

核心功能

  1. 运行多个实例:可以独立且同时运行多个相同类型的 MCP 服务器实例,每个实例在独立的隔离空间中运行,拥有单独的配置。
  2. 自动服务器重启:在开发过程中注册具有文件监视功能的 MCP 服务器,当检测到指定目录中的更改时,服务器会自动执行优雅重启。
  3. 基于 JSON 的配置系统:使用简单灵活的 JSON 配置格式定义多实例设置,每个服务器实例可以配置自己的命令、参数、环境变量、路径解析规则和文件监视设置。

适用场景

  • 运行多个 MySQL 服务器实例指向不同的数据库
  • 运行多个 Git 服务器实例使用不同的个人访问令牌
  • 运行多个文件系统服务器实例访问不同的根路径

工具列表

  1. JSON 配置工具:用于定义多实例设置,支持命令、参数、环境变量等配置。
  2. 文件监视工具:自动检测文件变化并重启服务器。
  3. 函数隐藏工具:选择性隐藏特定函数,限制访问危险或不必要的功能。
  4. 服务器启用/禁用工具:通过配置中的 enabled 标志临时禁用特定服务器。

常见问题解答

  1. 如何隐藏特定函数?:使用 hideFunctions 数组在配置中列出要隐藏的函数名称。
  2. 如何临时禁用服务器?:在配置中将 enabled 标志设置为 false
  3. 如何自动重启服务器?:在配置中启用 fileWatch 并指定监视路径。

使用教程

使用依赖

  1. 下载并安装 Claude Desktop 应用
  2. 确保已安装 npm

安装教程

  1. claude_desktop_config.json 中添加多实例服务器配置
  2. Mac 路径: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. Windows 路径: C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json
  4. 添加配置示例:
{
  "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"
      ]
    }
  }
}

调试方式

  1. 检查服务器是否在 Claude Desktop 启动时自动启动
  2. 验证每个实例的配置是否正确加载
  3. 检查文件监视功能是否正常工作(如配置)
  4. 验证隐藏函数是否确实不可用

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。