Codebase Analyzer MCP

Analyze any codebase with Gemini AI. Progressive disclosure keeps costs low - start with free structural analysis, drill into semantic details only when needed.

Quick Start

Claude Code Plugin

claude /plugin install https://github.com/jaykaycodes/codebase-analyzer-mcp

Then use /analyze, /patterns, /trace, or /explore commands.

MCP Server

Add to ~/.mcp.json (create if it doesn't exist):

{
  "mcpServers": {
    "codebase-analyzer": {
      "command": "npx",
      "args": ["-y", "codebase-analyzer-mcp"]
    }
  }
}

Restart Claude Code, then use the analyze_repo, find_patterns, or trace_dataflow tools.

Optional: For semantic analysis with Gemini AI, get an API key at https://aistudio.google.com/apikey and add it:

{
  "mcpServers": {
    "codebase-analyzer": {
      "command": "npx",
      "args": ["-y", "codebase-analyzer-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_api_key"
      }
    }
  }
}

CLI

npx codebase-analyzer-mcp analyze .                    # Standard analysis
npx codebase-analyzer-mcp analyze . -d surface         # Fast, free overview
npx codebase-analyzer-mcp analyze . -d deep -s         # Full semantic analysis
npx codebase-analyzer-mcp patterns .                   # Find design patterns
npx codebase-analyzer-mcp dataflow . "user login"      # Trace data flow

What It Does

| Layer | Cost | What You Get | |-------|------|--------------| | Surface | Free | Files, languages, entry points, modules | | Structural | Free | Symbols, imports, complexity (via tree-sitter) | | Semantic | Gemini | Architecture insights, pattern detection |

Analysis results include expandable sections - you only pay for what you drill into.

MCP Tools

| Tool | Description | |------|-------------| | analyze_repo | Full analysis with progressive disclosure | | expand_section | Drill into specific sections | | find_patterns | Detect design/architecture patterns | | trace_dataflow | Trace data flow through the system |

Plugin Commands & Agents

| Command | Agent | Purpose | |---------|-------|---------| | /analyze | architecture-analyzer | Full architecture analysis | | /patterns | pattern-detective | Find design patterns | | /trace | dataflow-tracer | Trace data flow | | /explore | codebase-explorer | Quick exploration | | /compare | - | Compare repositories |

Alternative Installation

Global Install

npm install -g codebase-analyzer-mcp
# Then use: cba analyze .

Development

git clone https://github.com/jaykaycodes/codebase-analyzer-mcp.git
cd codebase-analyzer-mcp
bun install
bun run dev           # Watch mode
bun run build:js      # Build JS
bun run cba analyze . # Test CLI

License

MIT

MCP Servers