# GodotForgeMCP / `godot-forge`

`godot-forge` is being built as a safe, progressive-disclosure MCP server + Godot editor addon + MCP App canvas for Godot 4.5→4.8-dev.

Current status: **M0 skeleton**.

## What works now

- TypeScript/Node 20+ MCP server skeleton.
- MCP 2026-07-28 negotiation over stdio.
- Stateless HTTP JSON-RPC skeleton with MCP routing headers.
- Capability probe for Godot binary, project root, C# project files, and GDScript LSP TCP 6005.
- Exactly five always-on tools:
  - `forge_search_tools`
  - `forge_describe_tool`
  - `forge_run`
  - `forge_inspect`
  - `forge_task_status`
- Durable task-shim store for M0 stub actions.
- Tool token-budget measurement gate.
- Local-client/Ollama smoke script that verifies MCP negotiation and gracefully reports when Ollama is not running.

## Quick start

```bash
npm install
npm run build
npm test
npm run smoke
npm run probe
```

Run as an MCP stdio server:

```bash
node dist/index.js
```

Run the HTTP skeleton:

```bash
node dist/index.js --http --host 0.0.0.0 --port 3333
```

See [`docs/M0_RUNBOOK.md`](docs/M0_RUNBOOK.md) for client configuration examples.

## Design docs

- [`docs/PRIOR_ART.md`](docs/PRIOR_ART.md)
- [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
- [`docs/TOOLS.md`](docs/TOOLS.md)
- [`docs/DECISIONS_AND_SCOPE.md`](docs/DECISIONS_AND_SCOPE.md)
- [`docs/M0_RUNBOOK.md`](docs/M0_RUNBOOK.md)

## License

MIT. Prior-art credit and implementation-derived notices will be maintained as code from or based on other projects is incorporated.