How to Install MCPX - MCP Gateway in Windsurf

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 ~/.codeium/windsurf/mcp_config.json
3Paste inside "mcpServers": {}
4Restart Windsurf

Configuration

File location: ~/.codeium/windsurf/mcp_config.json

mcp_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 Desktop 💻Claude Code ⌨️Cursor ✨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)