MCPX Control Plane MCP server

This server acts as an aggregator for multiple MCP (Model Context Protocol) servers, allowing you to manage connections to various AI services through simple configuration. MCPX eliminates the need for coding when integrating with MCP-compatible services, providing a unified API interface to multiple services through a central dispatcher.

Installation

You can run Lunar MCPX either locally or via Docker.

Prerequisites

Before installation, ensure you have an MCP-compatible client. If you don't have one yet, Claude Desktop is recommended.

Docker Installation

The simplest way to get started is using Docker:

docker run -p 8080:8080 lunarhq/mcpx:latest

For more detailed installation options, check the Official Docker Image Guide.

Usage

Connecting Clients to MCPX

Once your MCPX server is running, you can connect to it using any MCP-compatible client:

1. Your Own Client: Connect any custom MCP client to the server running on port 8080 (or your configured port).

2. Claude Desktop:

   • Open Claude Desktop
   • Go to Settings
   • Configure the MCP server URL to point to your MCPX instance (e.g., http://localhost:8080)

3. Cursor IDE:

   • Open Cursor settings
   • Navigate to the AI section
   • Set the MCP server URL to your MCPX instance

For detailed connection instructions for different clients, visit the following guides:

• Using your own client
• Connecting with Claude Desktop
• Connecting with Cursor

Using the Control Plane

MCPX includes a Control Plane interface that helps you:

• Monitor live traffic between clients and MCP servers
• Configure and manage your MCPX instance
• Debug connections and requests

To set up the Control Plane, follow the Control Plane setup instructions.

Additional Resources

For more detailed documentation including advanced configuration options, architecture details, and feature guides, visit the official Lunar MCPX documentation.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "mcpx" '{"command":"npx","args":["-y","@thelunarcompany/mcpx"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "mcpx": {
            "command": "npx",
            "args": [
                "-y",
                "@thelunarcompany/mcpx"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "mcpx": {
            "command": "npx",
            "args": [
                "-y",
                "@thelunarcompany/mcpx"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect