# mellos-mapping

A live terminal dependency tree showing agent progress from primitive layers to verified upper components.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 115
- Author: GuangminJu
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/GuangminJu/mellos-mapping
- Updated: 2026-10-13
- HTML: https://affpapa.org/en/nevibecode/mcp/mellos-mapping

## What it does

This MCP server renders a real-time layered architectural map in an adjacent terminal pane during development sessions. The graph represents systems from the bottom up, showing foundational modules at the base and disallowing upward-pointing edges. Planned components appear as dashed outlines, active tasks spin, and passing test suites turn completed blocks solid green.

The package bundles eight `mmap_*` MCP tools, a session launch hook, and an `/mmap` toggle command. The engine acts as a ledger, refusing broken structural hierarchies such as inverted dependencies while letting the model manage the build sequence. If an edit breaks a lower-level contract, that foundational node turns red under the dependent layers.

Running the server requires Node.js 18.17+ or 20.3+, plus Windows 10+, macOS 13.0+, or Linux with glibc 2.28+ on x64 or arm64. Without an existing Node.js environment on your PATH, the tools will fail to start.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mellos-mapping -- npx -y mellos-mapping
```

### Codex

**Platform CLI**
```bash
codex mcp add mellos-mapping -- npx -y mellos-mapping
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mellos-mapping": {
            "command": "npx",
            "args": [
                "-y",
                "mellos-mapping"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mellos-mapping": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mellos-mapping"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mellos-mapping npx -y mellos-mapping
```

## When to use it
- track agent progress across modular system layers
- spot broken foundational code before upper layers build
- enforce strict downward-only dependency boundaries
- review proposed project architecture before writing code

## Example prompts
- Declare the bottom-up architecture for the new engine and show the initial map.
- Run verification tests for layer L0 and mark verified nodes green.
- Toggle the active map pane using `/mmap`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

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