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:
58
morrowind/CONTEXT.md
Normal file
58
morrowind/CONTEXT.md
Normal 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
|
||||
Reference in New Issue
Block a user