WLADY_CODE MCP

Advanced codebase intelligence for AI assistants

🌐 English · Español

An MCP server that turns any codebase into a queryable knowledge graph — and renders it as an interactive galaxy.

What is it?

WLADY_CODE indexes your project, builds a dependency graph, and exposes 25 MCP tools that any compatible AI assistant (Claude, Cursor, etc.) can call to navigate, analyze, and reason about code with surgical precision.

It also spins up a local 3D galaxy visualization at http://localhost:9750 where every file is a star and every dependency is a luminous nebula edge.

┌──────────────────────────────────────────────────────────────┐
│                      WLADY_CODE MCP                          │
│                                                              │
│  ┌─────────────┐   ┌────────────────┐   ┌────────────────┐  │
│  │   Indexer   │──▶│   SQLite DB    │◀──│  25 MCP Tools  │  │
│  │ (Parser +   │   │ ~/.wlady-code  │   │                │  │
│  │   Graph)    │   │   -mcp/        │   │ navigation     │  │
│  └─────────────┘   │   wlady.db     │   │ impact         │  │
│                    └────────────────┘   │ analysis       │  │
│  ┌──────────────────────────────────┐   │ architecture   │  │
│  │  Galaxy UI  ·  localhost:9750    │   │ search · adr   │  │
│  └──────────────────────────────────┘   └────────────────┘  │
└──────────────────────────────────────────────────────────────┘

Related MCP server: Orihime

Why use it?

Features

Galaxy Visualization

The built-in web UI uses a stellar spectral color system — files are colored like real stars based on their connectivity:

Edges use Canvas 2D additive blending (globalCompositeOperation: 'lighter'), making dense dependency clusters glow brighter — the same effect as Three.js AdditiveBlending. Where many imports converge, a nebula appears.

Controls:

The code panel uses Prism.js with explicit grammar loading for 18+ languages, and includes an "Open in VS Code" button via the vscode://file/ protocol.

MCP Tools Reference

Supported Languages

TypeScript · JavaScript · Java · Kotlin · Python · Go · Rust · C · C++ · C# · PHP · Ruby · Swift · Dart · HTML · CSS/SCSS · JSON · YAML · SQL · Bash

Installation

Prerequisites

• Node.js 18+

• Claude Desktop, Cursor, or any MCP-compatible client

Linux only — better-sqlite3 compiles native bindings on install, so you need build tools:

# Debian / Ubuntu
sudo apt install python3 make g++

# Fedora / RHEL
sudo dnf install python3 make gcc-c++

# Arch
sudo pacman -S python make gcc

Build

git clone https://github.com/wladimania93/wlady-code-mcp
cd wlady-code-mcp
npm install
npm run build

Register with Claude Desktop

claude mcp add wlady-code -s user -- node "/absolute/path/to/wlady-code-mcp/dist/index.js"

Or manually in claude_desktop_config.json:

{
  "mcpServers": {
    "wlady-code": {
      "command": "node",
      "args": ["/absolute/path/to/wlady-code-mcp/dist/index.js"]
    }
  }
}

Index your first project

Ask your AI assistant:

Index the project at /path/to/my-project with id "my-project"

Or call the tool directly:

index_repository(
  project_path: "/path/to/my-project",
  project_id: "my-project",
  project_name: "My Project"
)

The galaxy visualization opens automatically at http://localhost:9750.

Environment variables

Project Structure

wlady-code-mcp/
├── src/
│   ├── index.ts              # MCP entry point + UI server bootstrap
│   ├── types.ts              # Shared types
│   ├── db/                   # SQLite access layer + schema
│   ├── parser/               # Per-language parsers
│   ├── indexer/              # Index orchestrator + incremental updates
│   ├── graph/                # BFS, DFS, shortest path, cycle detection
│   ├── search/               # BM25 search engine
│   ├── analysis/             # Complexity metrics + role classifier
│   ├── git/                  # Git integration (diff, branch compare)
│   ├── tools/                # All 25 MCP tool handlers
│   └── visualization/
│       ├── graph-data.ts     # SQLite → graph data queries
│       ├── server.ts         # HTTP server :9750 + /api/file endpoint
│       └── template.ts       # Self-contained UI (HTML + CSS + JS, ~34 KB)
└── dist/                     # Compiled output (run after npm run build)

Tech Stack

Inspiration & Credits

WLADY_CODE was built by combining the best of two excellent projects:

codebase-memory-mcp

The visual philosophy: represent a codebase as a galaxy where file importance maps to stellar spectral type, and dependency density creates glowing nebulae via additive color blending. The O/B/A/F/G/K/M spectral color system and the 3D graph architecture are directly inspired by their React + Three.js + Bloom implementation. Our version reimplements it with native Canvas 2D — eliminating build dependencies and serving a fully self-contained UI from the MCP process itself.

ops-codegraph-tool

The analysis philosophy: treat a codebase as a queryable knowledge graph, with specialized tools for navigation (where is X, what calls Y), impact analysis (if I change Z, what breaks), and quality auditing (dead code, complexity, circular dependencies). The modular handler structure by category and the real-time git integration are directly influenced by this project.

The synthesis: an MCP that sees code as a graph (codegraph) and renders it as a galaxy (codebase-memory) — all inside a single server with no external runtime dependencies.

WLADY_CODE v0.1.0 · Built with Node.js · Powered by MCP