使用说明

项目简介

Multiverse MCP Server 是一个中间件服务器,它能够让你同时运行多个独立的 MCP 服务器实例。它为每个服务器创建隔离的“宇宙”,防止冲突,并允许你管理不同的配置和命名空间。可以将其视为 MCP 服务器的管理器。

主要功能点

  • 运行多个隔离的 MCP 服务器实例: 支持同时运行多个相同或不同的 MCP 服务器,每个服务器都在自己的环境中独立运行。
  • 自动重启服务器: 在开发模式下,可以监控文件变化并自动重启受影响的服务器实例,方便开发和测试。
  • JSON 配置: 使用 JSON 文件灵活配置多重宇宙服务器,包括服务器命令、参数、环境变量、路径解析和文件监控等。
  • 功能前缀: 为每个被包裹的 MCP 服务器的功能添加前缀,避免功能名称冲突。
  • 隐藏特定功能: 可以选择性地隐藏被包裹服务器的某些功能,用于权限控制或简化接口。
  • 禁用服务器: 可以临时禁用某些服务器实例,而无需从配置文件中删除。

安装步骤

  1. 确保你已经下载并安装了 Claude Desktop 应用程序,并且已经安装了 npm。
  2. 编辑 'claude_desktop_config.json' 文件。该文件通常位于:
    • macOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
    • Windows: 'C:\Users<username>\AppData\Roaming\Claude\claude_desktop_config.json'
  3. 在 'claude_desktop_config.json' 文件的 'mcpServers' 字段下,添加你想要运行的 multiverse server 实例的配置。

服务器配置 (claude_desktop_config.json)

在 'claude_desktop_config.json' 中,你需要配置 multiverse server 的启动信息。以下是一个配置示例:

{
  "mcpServers": {
    "your-multiverse-server-name": {  // 你自定义的 multiverse server 名称 (在 Claude Desktop 中显示)
      "command": "npx",             // 启动 multiverse server 的命令
      "args": [                      // 命令参数
        "@lamemind/mcp-server-multiverse@latest", // multiverse server 的 npm 包名
        "/path/to/your/multiverse.json"          // 指向你的 multiverse 配置文件 (multiverse.json) 的路径
      ]
    }
  }
}
  • '"your-multiverse-server-name"': 是你为这个 multiverse server 实例起的唯一名称,这个名称会显示在 Claude Desktop 客户端中。
  • '"command": "npx"' 和 '"args": [...]"': 这是运行 npm 包的标准命令和参数。
  • '"/path/to/your/multiverse.json"': 关键步骤,你需要创建 'multiverse.json' 文件,并在其中定义你想要管理的实际 MCP 服务器。'multiverse.json' 文件的内容示例请参考仓库的 README 文档。

基本使用方法

  1. 创建 'multiverse.json' 配置文件: 根据你的需求,创建一个 'multiverse.json' 文件,在其中配置你想要包裹的 MCP 服务器实例。你可以参考仓库 README 中的示例来配置 'multiverse.json' 文件。
  2. 配置 Claude Desktop: 修改 'claude_desktop_config.json' 文件,添加 multiverse server 的配置,并将 'args' 中的路径指向你创建的 'multiverse.json' 文件。
  3. 启动 Claude Desktop: 启动 Claude Desktop 应用程序。Multiverse Server 和它所管理的 MCP 服务器将会自动启动。
  4. 使用功能: 在 Claude Desktop 中,你可以通过你在 'multiverse.json' 中定义的功能前缀来访问被包裹的 MCP 服务器的功能。例如,如果你的前缀是 'job',并且被包裹的服务器有一个 'read_file' 功能,你就可以在 Claude Desktop 中使用 'job_read_file' 来调用这个功能。

信息

分类

开发者工具