# hypermnesia-mcp-viz

hypermnesia-mcp-viz is an MCP server for Claude Code that turns Cortex memory, codebase graphs, and session logs into browser visualizations. Displays prompt traces and git diffs interactively.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: cdeust
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cdeust/cortex-viz
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/hypermnesia-mcp-viz

## What it does

The server provides six browser inspection perspectives over developer history: a project graph, a 3D structural model, execution traces, a consolidation board, a knowledge view, and a wiki. It stays strictly read-only and never creates or alters memory records, storing only computed graph layout caches in PostgreSQL.

Running the package requires Python 3.11 or newer. When running without a live Cortex PostgreSQL instance, the visualizer automatically falls back to no-DB mode, keeping the Trace screen active to parse local `~/.claude/projects/*.jsonl` logs alongside git commits.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add hypermnesia-mcp-viz -- uvx hypermnesia-mcp-viz
```
uvx runs the command named after the package; if the README names another one, use uvx --from hypermnesia-mcp-viz <command>

### Codex

**Platform CLI**
```bash
codex mcp add hypermnesia-mcp-viz -- uvx hypermnesia-mcp-viz
```
uvx runs the command named after the package; if the README names another one, use uvx --from hypermnesia-mcp-viz <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hypermnesia-mcp-viz": {
            "command": "uvx",
            "args": [
                "hypermnesia-mcp-viz"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from hypermnesia-mcp-viz <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hypermnesia-mcp-viz": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "hypermnesia-mcp-viz"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from hypermnesia-mcp-viz <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add hypermnesia-mcp-viz uvx hypermnesia-mcp-viz
```
uvx runs the command named after the package; if the README names another one, use uvx --from hypermnesia-mcp-viz <command>

## When to use it
- inspect Claude Code prompt and tool execution traces
- visualize codebase relationships and Cortex memory graphs
- browse local JSONL session logs with git diffs
- review project history across visual kanban and wiki views

## Example prompts
- Open the visual interface using `open_visualization`
- Launch the session trace view with `/cortex-visualize`

## Similar
- [create-viz](https://affpapa.org/en/nevibecode/skills/create-viz.md) — skill · 5400 installs
- [data-viz-renderer](https://affpapa.org/en/nevibecode/skills/data-viz-renderer.md) — skill · ★ 4719 repo stars
- [hypermnesia-mcp](https://affpapa.org/en/nevibecode/mcp/hypermnesia-mcp.md) — MCP server · ★ 78 repo stars
- [cortex-code](https://affpapa.org/en/nevibecode/skills/cortex-code.md) — skill · 1600 installs
- [snowflake-cortex-code](https://affpapa.org/en/nevibecode/plugins/snowflake-cortex-code.md) — plugin · ★ 45 repo stars
- [infographic-and-data-viz](https://affpapa.org/en/nevibecode/skills/infographic-and-data-viz.md) — skill · 1200 installs

---
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
