# THOR

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: nworks3d
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nworks3d/THOR-for-claude-code
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/thor

## What it 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.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add thor -- docker run -i --rm ghcr.io/nworks3d/thor-mcp:2.6.1
```

### Codex

**Platform CLI**
```bash
codex mcp add thor -- docker run -i --rm ghcr.io/nworks3d/thor-mcp:2.6.1
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "thor": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/nworks3d/thor-mcp:2.6.1"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "thor": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/nworks3d/thor-mcp:2.6.1"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add thor docker run -i --rm ghcr.io/nworks3d/thor-mcp:2.6.1
```

## When to use it
- 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
- Save this project rule: keep the Node.js range in `package.json` unchanged 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.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md