hypermnesia-mcp-viz — Claude Code MCP server: setup and overview
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.
MIT ★ 6 updated 2026-11-16
claude mcp add hypermnesia-mcp-viz -- uvx hypermnesia-mcp-vizWhat hypermnesia-mcp-viz 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.
What it helps with
- 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 for the agent
- Open the visual interface using
open_visualization - Launch the session trace view with
/cortex-visualize
How to install hypermnesia-mcp-viz
Platform CLI
claude mcp add hypermnesia-mcp-viz -- uvx hypermnesia-mcp-vizuvx runs the command named after the package; if the README names another one, use uvx --from hypermnesia-mcp-viz <command>
Platform CLI
codex mcp add hypermnesia-mcp-viz -- uvx hypermnesia-mcp-vizuvx runs the command named after the package; if the README names another one, use uvx --from hypermnesia-mcp-viz <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add hypermnesia-mcp-viz uvx hypermnesia-mcp-vizuvx runs the command named after the package; if the README names another one, use uvx --from hypermnesia-mcp-viz <command>
Step 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 hypermnesia-mcp-viz
How do I install hypermnesia-mcp-viz in Claude Code?
Run claude mcp add hypermnesia-mcp-viz -- uvx hypermnesia-mcp-viz in your terminal.
What does hypermnesia-mcp-viz do?
It spins up a browser UI presenting session logs, git history, and Cortex memory as interactive graphs. The server renders traces and diffs without writing any agent memories.
What is required to run hypermnesia-mcp-viz?
Python 3.11 or higher is required. A running Cortex PostgreSQL database unlocks all six views, while the standalone trace view requires only local Claude Code JSONL files and git.