feat: add MCP tool reference context file

Hermes loads this as session context so the model always has
exact tool names. Prevents mcp_morro hallucination loops.
This commit is contained in:
2026-03-27 23:22:36 +00:00
parent 67068aafd7
commit 4189e3d12c

58
morrowind/CONTEXT.md Normal file
View File

@@ -0,0 +1,58 @@
# Morrowind — MCP Tool Reference
You are connected to Morrowind (OpenMW) through MCP tools.
Use **exact** tool names. Never shorten or guess.
## Available Tools
| Tool | What it does |
|------|-------------|
| `mcp_mw_perceive` | Read game world: position, HP, magicka, fatigue, nearby NPCs, doors, items |
| `mcp_mw_status` | Check if OpenMW is running |
| `mcp_mw_move` | Move the player character (direction + duration) |
| `mcp_mw_action` | Perform a game action (activate, jump, attack, etc.) |
| `mcp_mw_screenshot` | Take a screenshot for vision analysis |
## Move Directions
`forward`, `backward`, `left`, `right`, `turn_left`, `turn_right`
Optional: `duration` (seconds, default 1.0), `run` (boolean, default false)
## Actions
`activate` — interact with what you're facing (NPCs, doors, items)
`jump` — jump
`attack` — swing weapon / cast spell
`journal` — open journal
`quicksave` — save game (F5)
`quickload` — load last save (F9)
`sneak` — toggle sneak
`wait` — do nothing this cycle
## Gameplay Loop
1. **Perceive first** — always call `mcp_mw_perceive` before deciding what to do
2. **Act once** — one move or action per cycle, then perceive again
3. **Quicksave often** — before entering new areas, before combat, before talking to NPCs
4. **If a tool call fails** — check the exact tool name. Do NOT retry the same broken call.
## Error Recovery
If you get "Method not found":
- You used the wrong tool name. The tools above are the ONLY valid names.
- Stop. Check spelling. Try again with the correct name.
- If it still fails after 2 attempts, report the error and stop calling MCP tools.
## What You Can See
Perception returns:
- `cell` — current location name
- `position` — x,y,z coordinates
- `yaw` — facing direction (radians)
- `health`, `magicka`, `fatigue` — vital stats
- `npcs` — nearby NPCs with name and distance
- `doors` — nearby doors with name and distance
- `items` — nearby items with name and distance
- `mode` — current mode (walking, combat, menu, etc.)
- `game_time` — in-game time