home / mcp / mcp-hub-mcp server

MCP-Hub-MCP Server

Hub server that connects to and manages multiple MCP servers via a configurable JSON file and a simple toolset.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "warpdev-mcp-hub-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-hub-mcp",
        "--config-path",
        "/Users/username/mcp.json"
      ]
    }
  }
}

You have a hub that connects to and manages multiple MCP servers from a single place. This hub keeps your active tool set focused, reduces context switching, and prevents clutter from rarely used MCPs while still giving you quick access to their capabilities when needed.

How to use

You connect to other MCP servers via a configuration file and then interact with them through a simple set of tools. The hub lets you list tools from all connected servers, call a specific tool on a chosen server, or search for tools across all connected servers using patterns.

How to install

# Clone repository
git clone <repository-url>
cd mcp-hub-mcp

# Install dependencies
npm install
# or
yarn install
# or
pnpm install
```

```
# Build the project
npm run build
# or
yarn build
# or
pnpm build
```

```
# Start the hub server
npm start
# or
yarn start
# or
pnpm start
```

```
# Development mode (optional)
npm run dev
# or
yarn dev
# or
pnpm dev

Configuration and usage notes

Configure the hub to connect to other MCP servers by providing a configuration file. The hub supports specifying multiple MCP servers under the mcpServers section. You can also control how the hub locates the configuration file using the MCP_CONFIG_PATH environment variable or a --config-path command line option.

Example configuration snippet shows how to define a connected server using a local npx command. This enables the hub to spawn MCP servers on demand via a single interface.

{
  "mcpServers": {
    "other_tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-hub-mcp",
        "--config-path",
        "/Users/username/mcp.json"
      ]
    }
  }
}

Available tools

list-all-tools

Lists all tools from every connected MCP server, giving you a quick overview of what is available across the active toolset.

call-tool

Calls a specific tool on a chosen MCP server, passing the required arguments to execute the task and return results.

find-tools

Searches for tools across all connected MCP servers using a regex pattern to filter by name or description.