# Wingbox

Wingbox is a Claude Code MCP server that maps project dependencies before editing code. It evaluates the blast radius of changes locally without sending files to external networks.

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

## What it does

Wingbox builds a repository code graph via static parsing rather than language models or vector indexes. The tool maps call hierarchies, imports, and component boundaries across Python, TypeScript, Rust, Go, Java, C#, PHP, and Ruby.

Generated files stay inside the local `.wingbox/` directory, which holds `index.sexp`, a summary `REPORT.md`, and a standalone `map.html` view. Running the server requires `uv` or `uvx` on the host machine. No API token, account, or internet connection is needed.

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

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- trace change blast radius before modifying source files
- inspect call flows across repository modules
- navigate architecture boundaries in large codebases
- track dependent components without third-party network calls

## Example prompts
- Build the code graph and report architectural boundaries
- Check what files break if I edit `src/auth/service.py`
- Show the call hierarchy for the order processing handler

## Similar
- [trailmark](https://affpapa.org/en/nevibecode/skills/trailmark.md) — skill · 4600 installs
- [hivemind-graph](https://affpapa.org/en/nevibecode/skills/activeloopai-hivemind-graph.md) — skill · ★ 1658 repo stars
- [knowing](https://affpapa.org/en/nevibecode/mcp/knowing.md) — MCP server · ★ 24 repo stars
- [gitnexus-pdg-query](https://affpapa.org/en/nevibecode/skills/gitnexus-pdg-query.md) — skill · 405 installs
- [ai-architect-mcp-codebase](https://affpapa.org/en/nevibecode/mcp/ai-architect-mcp-codebase.md) — MCP server · ★ 8 repo stars
- [Symvanta](https://affpapa.org/en/nevibecode/mcp/symvanta.md) — MCP server

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