# CodeGraphy Lite

> Open-source visual architecture graph and MCP server that maps Python codebases for developers and AI coding agents.

CodeGraphy Lite is the standalone open-source distribution of CodeGraphy, published under the MIT license. It scans a Python project, renders an interactive 2D architecture canvas in the browser, and exposes the same architectural data to AI assistants through a built-in MCP server. It installs from PyPI and runs locally.

## What It Is

CodeGraphy Lite is a code-architecture visualization tool and Model Context Protocol server. Pointed at a project directory, it scans up to 35 files using Python's standard-library `ast.parse()` plus regex import matching, then shows modules, services, and dependency edges as a draggable graph. Topics can be grouped into workflow lanes such as Planning, Development, Testing, and Done, and workspaces can be exported and imported as human-readable `.cg.md` Markdown files.

## How the MCP Server Works

The `codegraphy-mcp` command speaks JSON-RPC 2.0 over STDIO (MCP 2024-11-05) and offers three tools: `list_workspace_topics`, `get_topic_context` (topic details, 1-hop dependencies, and AST-extracted class and function signatures), and `get_architecture_summary` (metrics, dependency statistics, and status distribution). The README gives configuration examples for Cursor and Claude Code, and names Windsurf and Cline as target agents.

## Local Use and Context Savings

The README states that the tool is local-first, with no cloud telemetry or code uploads. It also reports a benchmark across six closed bugfixes in httpx, typer, and rich in which agent input tokens fell by 75.5% compared with grep plus whole-file reading, with the same 6/6 acceptance pass rate. This is a vendor-published result.

## Setup Path

Install with `pip install codegraphy-lite`, then run `codegraphy-lite` in a project directory. The server defaults to 127.0.0.1:8000 and opens the browser; flags control port, host, browser launch, and forced scanning. The README distinguishes Lite from a separate CodeGraphy Pro edition, which it says supports more languages and larger projects.

## Features
- Interactive React Flow architecture graph with drag-and-drop layout
- Workflow lanes (Planning, Development, Testing, Done)
- Semantic zoom with level-of-detail
- Portable .cg.md workspace import/export
- Lightweight Python AST scanner (up to 35 files)
- STDIO MCP server with three architecture tools
- Local-first with no telemetry or code uploads
- Browser-based web UI served locally

## Integrations
Cursor, Claude Code, Windsurf, Cline, Model Context Protocol

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source, Free tier available

## Version
1.0.1

## Links
- Website: https://github.com/Vindettobkb/CodeGraphy-lite
- Documentation: https://github.com/Vindettobkb/CodeGraphy-lite
- Repository: https://github.com/Vindettobkb/CodeGraphy-lite
- EveryDev.ai: https://www.everydev.ai/tools/codegraphy-lite
