A harness for driving a Godot 4 project from an agent: editor addons, a runtime bridge into the running game, an MCP server in front of them, and a CLI that installs and diagnoses the Godot side.
- ✓Open-source license (MIT)
- ✓Actively maintained (<30d)
- ✓Clear description
- ✓Topics declared
- ✓Documented (README)
git clone https://github.com/Aureliolo/gdharness{
"mcpServers": {
"gdharness": {
"command": "node",
"args": ["/path/to/gdharness/dist/index.js"]
}
}
}MCP Servers overview
# gdharness
[](https://github.com/Aureliolo/gdharness/actions/workflows/ci.yml)
[](https://scorecard.dev/viewer/?uri=github.com/Aureliolo/gdharness)
[](https://www.bestpractices.dev/projects/14619)
[](https://www.bestpractices.dev/projects/14619)
[](.github/release-process.md#slsa)
[](.github/release-process.md#what-a-release-carries)
[](.github/release-process.md#verifying-a-release)
[](https://www.npmjs.com/package/gdharness)
[](https://github.com/Aureliolo/gdharness/releases)
[](https://modelcontextprotocol.io/introduction)
[](https://godotengine.org)
[](https://nodejs.org/)
[](https://bun.sh/)
[](LICENSE)
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:**
```text
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](https://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.
```jsonc
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](https://aureliolo.github.io/gdharness): installing it, how the
parts connect, and every tool, op and argument.
[SECURITY.md](.github/SECURITY.md) is how to report something.
[CONTRIBUTING.md](.github/CONTRIBUTING.md) is what a change has to clear.
## Project
Fork of [GoPeak](https://github.com/HaD0Yun/Doyunha-Gopeak) v2.3.9, September 2026, MIT: the
original MCP server [godot-mcp](https://github.com/Coding-Solo/godot-mcp) by
[Solomon Elias](https://github.com/Coding-Solo), GoPeak by [HaD0Yun](https://github.com/HaD0Yun),
and completely reworked since to be hardened, condensed and more streamlined.
Not affiliated with the Godot Foundation.
What people ask about gdharness
What is Aureliolo/gdharness?
+
Aureliolo/gdharness is mcp servers for the Claude AI ecosystem. A harness for driving a Godot 4 project from an agent: editor addons, a runtime bridge into the running game, an MCP server in front of them, and a CLI that installs and diagnoses the Godot side. It has 1 GitHub stars and its last recorded update is dated 2026-09-14.
How do I install gdharness?
+
You can install gdharness by cloning the repository (https://github.com/Aureliolo/gdharness) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is Aureliolo/gdharness safe to use?
+
Our security agent has analyzed Aureliolo/gdharness and assigned a Trust Score of 95/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains Aureliolo/gdharness?
+
Aureliolo/gdharness is maintained by Aureliolo. The last recorded GitHub activity is dated 2026-09-14, with 1 open issues.
Are there alternatives to gdharness?
+
Yes. On ClaudeWave you can browse similar mcp servers at /categories/mcp, sorted by popularity or recent activity.
Deploy gdharness to your cloud
Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.
Maintain this repo? Add a badge to your README
Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.
[](https://claudewave.com/repo/aureliolo-gdharness)<a href="https://claudewave.com/repo/aureliolo-gdharness"><img src="https://claudewave.com/api/badge/aureliolo-gdharness" alt="Featured on ClaudeWave: Aureliolo/gdharness" width="320" height="64" /></a>More MCP Servers
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
An open-source AI agent that brings the power of Gemini directly into your terminal.
Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface
🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
The fastest path to AI-powered full stack observability, even for lean teams.