Skip to main content

⌨️ MCP Integration

The optimal workflow for C++ programming with Ludus AI is through MCP. The Model Context Protocol is the standard way to integrate Ludus AI's deep Unreal Engine knowledge directly into your development environment. By connecting the Ludus MCP server, your IDE or tool can reference expert-level C++ and engine knowledge to answer technical queries without you leaving your workflow.

Plugin vs. MCP​

The Ludus Unreal Engine Plugin is useful for quick snippets but is not recommended for heavy code iteration. It lacks specific context about your project's variables and architecture. For implementing and iterating on code, always use the MCP integration to ensure efficiency and context-awareness.

Intelligent Model Selection​

Through MCP, Ludus offers access to both its Lite and Full knowledge modes. You don't need to manually switch between them; simply include your preference in your prompt (e.g., "Using the Full mode, explain...") or let Ludus automatically select the most appropriate mode for your specific query. Usage costs for MCP are identical to standard plugin or app usage for both Lite and Full modes.

Below are the installation and configuration instructions for supported tools.

Rider​

Installation​

  1. Open Settings.
  2. Navigate to Junie -> MCP Settings.
  3. Click Add.
  4. Configure the Ludus MCP server using the JSON configuration below.

Configuration​

{
  "mcpServers": {
    "ludus-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ludusengine.com/mcp"
      ]
    }
  }
}

Visual Studio​

Installation​

  1. Add a new file at <SOLUTIONDIR>\.mcp.json or %USERPROFILE%\.mcp.json.
  2. Configure the Ludus MCP server using the JSON configuration below.
  3. Click the "Manage Authentication" button above "ludus-mcp" in .mcp.json.
  4. Visit the Visual Studio documentation for more info.

Configuration​

{
  "mcpServers": {
    "ludus-mcp": {
      "url": "https://mcp.ludusengine.com/mcp"
    }
  }
}

Cursor​

Installation​

  1. Open Cursor Settings.
  2. Navigate to Tools & MCP.
  3. Click on New MCP Server.
  4. Configure the Ludus MCP server with the JSON snippet below.
  5. Authentication: Once added, Cursor will display a "Needs login" prompt. Click it to authorize Cursor to access your Ludus account.

Alternatively, you can add the snippet to your project-specific .cursor/mcp.json file manually.

Configuration​

{
  "mcpServers": {
    "ludus-mcp": {
      "url": "https://mcp.ludusengine.com/mcp"
    }
  }
}

Claude Code​

Installation​

  1. Install Claude Code:

    npm install -g @anthropic-ai/claude-code

  2. Add Ludus MCP:

    claude mcp add --transport http ludus-mcp https://mcp.ludusengine.com/mcp

  3. Start coding with Claude: claude

  4. Authenticate the MCP tools by typing /mcp.

You can also add the snippet to your project-specific .mcp.json file manually.

Configuration​

{
  "mcpServers": {
    "ludus-mcp": {
      "url": "https://mcp.ludusengine.com/mcp"
    }
  }
}

Codex​

Installation​

  1. Install Codex:

    npm i -g @openai/codex

  2. Add Ludus MCP:

    codex mcp add --url https://mcp.ludusengine.com/mcp ludus-mcp

  3. Start coding with Codex: codex

  4. Authenticate the MCP tools by typing /mcp.

You can also add the configuration to your ~/.config/codex/.mcp.json file.

Configuration​

{
  "mcpServers": {
    "ludus-mcp": {
      "url": "https://mcp.ludusengine.com/mcp"
    }
  }
}

Gemini CLI​

Installation​

  1. Install Gemini CLI:

    npm install -g @google/gemini-cli

  2. Add Ludus MCP:

    gemini mcp add --transport http ludus-mcp https://mcp.ludusengine.com/mcp

  3. Start coding with Gemini CLI: gemini

  4. Authenticate the MCP tools by typing /mcp.

You can also add the configuration to your ~/.config/gemini/mcp.json file.

Configuration​

{
  "mcpServers": {
    "ludus-mcp": {
      "url": "https://mcp.ludusengine.com/mcp"
    }
  }
}

VS Code​

Installation​

  1. Press CTRL/CMD + P and search for MCP: Add Server.
  2. Select HTTP (HTTP or Server-Sent Events).
  3. Enter the URL: https://mcp.ludusengine.com/mcp and hit Enter.
  4. Enter the name Ludus MCP and hit Enter.
  5. Activate the server using MCP: List Servers, selecting Ludus MCP, and selecting Start Server.

You can also add the snippet to your project-specific .vscode/mcp.json file manually.

Configuration​

{
  "servers": {
    "ludus-mcp": {
      "type": "http",
      "url": "https://mcp.ludusengine.com/mcp"
    }
  }
}

Other MCP Integrations​

Installation Parameters​

  • Command: npx
  • Arguments: -y mcp-remote https://mcp.ludusengine.com/mcp

Configuration​

{
  "mcpServers": {
    "ludus-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ludusengine.com/mcp"
      ]
    }
  }
}