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