# koment MCP server

> Allows AI agents and developers to record and verify code rationale in external YAML files to prevent documentation rot.

- Repository: https://github.com/koment-dev/koment
- Page: https://hostedmcp.org/servers/koment-dev/koment
- Transport: stdio
- Stars: 1
- License: AGPL-3.0
- Latest version: 3.2.0

## Install

### Claude Code

```sh
claude mcp add koment -- docker run -i --rm ghcr.io/koment-dev/koment:3.2.0
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "koment": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/koment-dev/koment:3.2.0"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "koment": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/koment-dev/koment:3.2.0"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"koment","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/koment-dev/koment:3.2.0"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "koment": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/koment-dev/koment:3.2.0"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add koment -- docker run -i --rm ghcr.io/koment-dev/koment:3.2.0
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.koment]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/koment-dev/koment:3.2.0"]
```

### Gemini CLI

```sh
gemini mcp add -s user koment docker -- run -i --rm ghcr.io/koment-dev/koment:3.2.0
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "koment": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/koment-dev/koment:3.2.0"
      ]
    }
  }
}
```

## FAQ

### Where is the rationale data stored?

The records are stored as YAML files within a .koment/ directory inside your own git repository.

### Can AI agents use koment?

Yes, it provides an MCP server that allows agents like Claude Code and Cursor to read and write reasoning annotations, ensuring they follow the recorded rationale.
