Skip to main content

Quickstart

This guide starts a Broxy proxy with one downstream MCP server.

1) Install the CLI​

Download the latest CLI jar from the releases page or build it from source.

2) Create your config directory​

Create a directory with mcp.json and a preset file.

mkdir -p ~/.config/broxy

mcp.json

{
  "requestTimeoutSeconds": 60,
  "capabilitiesTimeoutSeconds": 30,
  "capabilitiesRefreshIntervalSeconds": 300,
  "mcpServers": {
    "files": {
      "name": "File MCP",
      "transport": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp-files-server.js"],
      "env": {
        "API_TOKEN": "${FILE_SERVER_TOKEN}"
      }
    }
  }
}

preset_developer.json

{
  "id": "developer",
  "name": "Developer",
  "tools": [
    {"serverId": "files", "toolName": "readFile", "enabled": true},
    {"serverId": "files", "toolName": "writeFile", "enabled": true}
  ],
  "prompts": [],
  "resources": []
}

3) Run the proxy​

java -jar /path/to/broxy-cli.jar proxy \
  --config-dir ~/.config/broxy \
  --preset-id developer \
  --inbound stdio \
  --log-level info

4) Connect your client​

Point your MCP client at the Broxy stdio process or switch to streamable HTTP with --inbound http. All inbound tool calls must be prefixed as serverId:toolName.