GodotLens MCP Server

by pzalutski-pixelio.github.pzalutski-pixel/godotlensv1.1.1

Semantic GDScript analysis via Godot's built-in LSP: navigation, references, diagnostics, rename and file sync.

9Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install GodotLens MCP server

claude mcp add godotlens -- npx -y godotlens-mcp

{
  "mcpServers": {
    "godotlens": {
      "command": "npx",
      "args": [
        "-y",
        "godotlens-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "godotlens": {
      "command": "npx",
      "args": [
        "-y",
        "godotlens-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "godotlens": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "godotlens-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "godotlens": {
      "command": "npx",
      "args": [
        "-y",
        "godotlens-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GODOT_LSP_HOST	—	—	Godot language server host
GODOT_LSP_PORT	—	—	Godot language server port (the VS Code extension uses 6008)
GODOT_DAP_HOST	—	—	Godot debug adapter host
GODOT_DAP_PORT	—	—	Godot debug adapter port, used by the debug_* tools
GODOT_BIN	—	—	Godot executable, required by scene_* and project_config
GODOT_PROJECT_ROOT	—	—	Project root; auto-detected by walking up for project.godot
GODOT_LSP_TIMEOUT	—	—	Seconds to wait for a single LSP response
GODOT_DIAGNOSTICS_TIMEOUT	—	—	Seconds to wait for diagnostics after a sync
GODOT_VERSION	—	—	Override Godot capability detection
GODOT_FIND_FILE_LIMIT	—	—	Max files gdscript_find inspects across the project