MCP Client Setup

MCP Client Configuration

The Elemm Gateway is a universal Model Context Protocol (MCP) server. Any AI client or editor that supports MCP (such as Claude Desktop, Cursor, Cline/Roo Code, or Windsurf) can connect to it.

Since it uses the STDIO transport by default, you do not run it directly in your terminal. Instead, you configure your chosen AI client to start it in the background using the standard mcpServers JSON block.

1. General Config Schema

Most MCP clients support standard configuration blocks. To connect to the Elemm Gateway, add the following to your client's MCP settings configuration file:

Local Python Executable (Recommended)

{
  "mcpServers": {
    "elemm-gateway": {
      "command": "/path/to/your/project/.venv/bin/python3",
      "args": ["-m", "elemm_gateway.cli"]
    }
  }
}

• command: The absolute path to the Python executable inside your virtual environment.
• args: List of arguments to pass to the CLI. ["-m", "elemm_gateway.cli"] launches the gateway module.

2. Platform-Specific Setup

Claude Desktop

Configure the JSON file at the following path:

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

If running on WSL (Windows Subsystem for Linux) while Claude Desktop runs on Windows:

{
  "mcpServers": {
    "elemm-gateway": {
      "command": "wsl.exe",
      "args": [
        "-d", "Ubuntu", "-u", "<WSL_USERNAME>",
        "bash", "-c",
        "cd /home/<WSL_USERNAME>/project && ./.venv/bin/python3 -m elemm_gateway.cli"
      ]
    }
  }
}

Cursor

1. Go to Cursor Settings -> Features -> MCP.
2. Click + Add New MCP Server.
3. Set the following details:

• Name: elemm-gateway
• Type: stdio
• Command: /path/to/project/.venv/bin/python3
• Arguments: -m elemm_gateway.cli

Cline / Roo Code (VS Code)

To configure the MCP server in VS Code extensions, add the configuration schema to the respective settings file:

Cline

• macOS/Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Roo Code (formerly Roo Cline)

• macOS/Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/roo_mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\roo_mcp_settings.json

3. Testing the Connection

Once the client is configured and restarted, ask your agent:

"Use Elemm to connect to https://petstore.swagger.io/v2/swagger.json and list all available pets."