How to Install MCPX - MCP Gateway in Claude Desktop

A lightweight, open-source gateway for orchestrating and securing your MCP ecosystem.

What MCPX - MCP Gateway does

Lunar.dev MCPX is a lightweight, centralized gateway for managing and securing your local-first MCP workflows. Designed for developers working with multiple MCP-compatible tools and services, MCPX acts as a smart proxy, routing requests, enforcing permissions, and simplifying integrations across your stack. At its core, MCPX helps you: * Dynamically route between multiple MCP servers * Connect to tools and services with zero code via simple JSON configuration * Expose a unified API interface across disparate services * Adopt a remote-first approach without losing the local flexibility MCP offers Whether you're exploring how to structure secure agent workflows or deploying agents into production environments, this documentation will walk you through every step, from setup to advanced configurations.

mcp_gateway

mcp_aggregator

control_plane

agent_governance

mcp_governance

Installation steps

1Copy the config below
2Open claude_desktop_config.json
3Paste inside "mcpServers": {}
4Restart Claude Desktop

Configuration

File location: ~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.jsonjson

{
  "mcpxMcpGateway": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "--pull",
      "always",
      "--privileged",
      "-v",
      "./:/lunar/packages/mcpx-server/config",
      "-p",
      "9000:9000",
      "-p",
      "5173:5173",
      "-p",
      "3000:3000",
      "--name",
      "mcpx",
      "us-central1-docker.pkg.dev/prj-common-442813/mcpx/mcpx:latest"
    ]
  }
}

Full server details GitHub Open Config Editor

Install in other clients

💻Claude Code ⌨️Cursor 🏄Windsurf ✨OpenAI ♊Gemini

For maintainers

If you maintain MCPX - MCP Gateway, add this badge to your README to show it's verified on CuratedMCP:

[![CuratedMCP Verified](https://www.curatedmcp.com/api/badge/mcpx-mcp-gateway)](https://www.curatedmcp.com/marketplace/mcpx-mcp-gateway)