What is io.github.Aureliolo/gdharness?

A harness for driving a Godot 4 project from an agent: addons, runtime bridge, MCP server, CLI.

How do I install io.github.Aureliolo/gdharness?

Clone io.github.Aureliolo/gdharness from https://github.com/Aureliolo/gdharness and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

Is io.github.Aureliolo/gdharness open source?

Yes, io.github.Aureliolo/gdharness is open source under the MIT license. Source code is available at https://github.com/Aureliolo/gdharness.

What category does io.github.Aureliolo/gdharness belong to?

io.github.Aureliolo/gdharness is listed under Developer Tools MCP servers on MCPFind.

io.github.Aureliolo/gdharness — MCP Server for Developer Tools

gdharness

Drive a Godot 4 project from an agent: the editor that is open, the game that is running, and the project on disk.

Hand this to your agent:

Install gdharness into this project by following
https://aureliolo.github.io/gdharness/agent.md, then tell me what it asked you to
recommend back to me.

Or do it yourself, and pick your harness: aureliolo.github.io/gdharness

What it is for

An agent cannot see a running game. This makes one answerable: where a control is, what a property reads, what the console printed, what broke and on which line.

runtime_inspect { "op": "rect", "nodePath": "/root/Hall/Ledger/BuyButton" }

{ "canvas": { "position": { "x": 812, "y": 418 }, "size": { "x": 180, "y": 34 } },
  "visible": true }

At a glance


Needs	Godot 4.7 or newer, Node 22 or newer. Runs under Bun 1.4 too.
Surface	30 tools named `domain_verb`, and 4 `godot://` resources
Reaches	The editor that is open, a game it is playing, and the project on disk
Harnesses	35, written inside the project wherever the harness has a project config
Skill	Written to `.agents/skills`, which every major harness reads
Install	npm, or a Sigstore-signed archive with an SBOM, SLSA Build Level 3
Proven	Every tool driven against a pinned Godot in CI, on three platforms

Documentation

aureliolo.github.io/gdharness: installing it, how the parts connect, and every tool, op and argument.

SECURITY.md is how to report something. CONTRIBUTING.md is what a change has to clear.

Project

Fork of GoPeak v2.3.9, September 2026, MIT: the original MCP server godot-mcp by Solomon Elias, GoPeak by HaD0Yun, and completely reworked since to be hardened, condensed and more streamlined.

Not affiliated with the Godot Foundation.

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-aureliolo-gdharness": {
      "command": "npx",
      "args": [
        "-y",
        "gdharness"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.Aureliolo/gdharness works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.Aureliolo/gdharness