THOR — Claude Code MCP server: memory and setup
THOR keeps project notes close at hand and can block a matching change when a note includes a live check. Use it to carry project rules across coding sessions.
claude mcp add thor -- docker run -i --rm ghcr.io/nworks3d/thor-mcp:2.6.1What THOR does
THOR keeps a separate set of notes for each project. The agent sees a note when it opens a related file or runs a related command, so project guidance can appear in a fresh conversation. A note with a check that still passes can stop a matching edit or command before it happens. Notes without a check remain guidance; they cannot block work.
The server runs locally, and the Claude Code setup command starts it with Docker. THOR also flags stale notes and reviews notes that were surfaced during work. Rules with checks that can refuse an edit are not hidden by that review process. Docker is needed to run the supplied installation command, while memory stays on the machine by default.
What it helps with
- show project guidance when an agent reaches a related file
- block an edit that breaks a checkable project rule
- keep notes from separate repositories apart
- spot stale or rarely surfaced project notes
Example prompts for the agent
- Save this project rule: keep the Node.js range in
package.jsonunchanged while the build relies on the older version. - Check the note for this file before editing it, and stop if its proof still holds.
- Show project notes that refer to files or commands that no longer apply.
How to install THOR
Platform CLI
claude mcp add thor -- docker run -i --rm ghcr.io/nworks3d/thor-mcp:2.6.1Platform CLI
codex mcp add thor -- docker run -i --rm ghcr.io/nworks3d/thor-mcp:2.6.1Config file
{
"mcpServers": {
"thor": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nworks3d/thor-mcp:2.6.1"
]
}
}
}Config file
{
"servers": {
"thor": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nworks3d/thor-mcp:2.6.1"
]
}
}
}Platform CLI
gemini mcp add thor docker run -i --rm ghcr.io/nworks3d/thor-mcp:2.6.1Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about THOR
How do I install THOR in Claude Code?
Run claude mcp add thor -- docker run -i --rm ghcr.io/nworks3d/thor-mcp:2.6.1. Docker is required to run this command.
What does THOR do?
It stores notes separately for each project and surfaces them when the agent reaches related files or commands. Notes backed by a live check can block matching changes.
Does THOR need an API key?
No. THOR runs locally without an account or API key, and its memory stays on your machine by default.
