MCP Server Multiverse

🚀 Multiverse Multi-World Server

Multiverse is a powerful multi-server management platform that allows you to run and manage multiple independent server instances within a single MCP (Model Context Protocol) server. Each server instance can have different functions, configurations, and purposes, enabling efficient resource utilization and flexible expansion.

🚀 Quick Start

Multiverse provides a convenient way to manage multiple server instances in one MCP server. You can configure different server instances according to your needs to achieve efficient resource utilization.

✨ Features

• File Monitoring: Track file changes in specified directories in real-time to ensure the normal operation of features like code hot updates.
• Environment Variable Settings: Provide necessary runtime parameters for each server instance by configuring environment variables, such as GitHub personal access tokens.
• Function Hiding: Selectively hide specific functions to limit potential security risks or simplify the user interface.
• Server Disabling: Temporarily disable certain server instances without deleting the configuration, facilitating development and testing.

📦 Installation

There is no explicit installation step provided in the original README. So this section is skipped.

💻 Usage Examples

Basic Usage

Here are some basic configuration examples:

1. Basic Configuration

{
  "serverName": "Example Server",
  "functionsPrefix": "example-prefix",
  "servers": [
    {
      "command": "node",
      "args": ["./build/index.js"],
      "fileWatch": {
        "enabled": true,
        "path": "./build"
      }
    },
    {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github@latest"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<Your Personal Access Token>"
      }
    }
  ]
}

2. File Monitoring

"fileWatch": {
  "enabled": true,
  "path": "/my-own/mcp-server/i-m-working-on/build/"
}

3. Function Hiding

"hideFunctions": ["create_repository", "delete_repository", "create_issue"]

Advanced Usage

Here is a complete example of the multiverse.json file:

{
  "serverName": "Large Project Resource Explorer",
  "functionsPrefix": "huge-project",
  "servers": [
    {
      "command": "node",
      "args": ["./build/index.js"],
      "fileWatch": {
        "enabled": true,
        "path": "./build"
      }
    },
    {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem@latest"],
      "args": ["/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"]
      }
    }
  ]
}

📚 Documentation

Planned Features

• [ ] Support for prompt management
• [ ] Support for resource management
• [ ] Addition of a graphical user interface (GUI) for managing multi-world servers

Verified Platforms

• [x] Windows operating system
• [ ] macOS system
• [ ] Linux system

📄 License

This project is licensed under the MIT License. Please refer to the relevant documentation for specific terms.