Skip to main content
Version: Next

Get Started Locally

Set Up Locally​

  1. Clone the repository and install dependencies for mcpx-server:
git clone https://github.com/TheLunarCompany/lunar.git
cd lunar/mcpx
npm install
  1. Build:
npm run build:deps
  1. Run the server:
cd packages/mcpx-server
npm run start

  1. Create a config directory with mkdir config. We will use it in order to easily mount config to MCPX.

  2. Place the following config under mcpx-server/config/mcp.json. It uses a single MCP server that requires no credentials, for quick start set up.

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone=America/New_York"]
    }
  }
}

MCPX runs by default on port :9000, or via a custom port supplied via the PORT environment variable.

MCPX loads a general configuration file listing general application configuration at mcpx-server/config/app.yaml (overridable by the APP_CONFIG_PATH environment variable).

Congratulations!​

You have now set up your MCPX. You should see the following lines to indicte a successful installation:

Starting mcpx server... ⚡️ 
Server started on port 9000