About codebase-analyzer
codebase-analyzer is an MCP server published by git+jaykaycodes in the Developer Tools category: multi-layer codebase analysis MCP server with Gemini AI and progressive disclosure.
Install
npx codebase-analyzer-mcpclaude mcp add codebase-analyzer-mcp -- npx -y codebase-analyzer-mcpnpx -y codebase-analyzer-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (7)
analyze_repoFull analysis with progressive disclosure
Parameters not published.
expand_sectionDrill into specific analysis sections
Parameters not published.
find_patternsDetect design/architecture patterns
Parameters not published.
get_analysis_capabilitiesList supported languages and options
Parameters not published.
query_repoAsk questions about a codebase
Parameters not published.
read_filesRead source files from a cached analysis
Parameters not published.
trace_dataflowTrace data flow through the system
Parameters not published.
Ask AI
Ask AI about codebase-analyzer
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
4 checks have not been run yet.
README
Codebase Analyzer MCP
MCP server for codebase analysis with Gemini AI. Progressive disclosure keeps costs low — start with free structural analysis, drill into semantic details only when needed.
Install
Add to your MCP config (~/.mcp.json for Claude Code):
{
"mcpServers": {
"codebase-analyzer": {
"command": "npx",
"args": ["-y", "codebase-analyzer-mcp"],
"env": {
"GEMINI_API_KEY": "your_key_here"
}
}
}
}
Restart Claude Code. The tools will be available immediately.
Gemini API key is optional — enables semantic analysis, pattern detection, and dataflow tracing. Without it, you still get structural analysis. Get a free key at https://aistudio.google.com/apikey
Tools
| Tool | Description | Requires Gemini |
|---|---|---|
analyze_repo |
Full analysis with progressive disclosure | No |
query_repo |
Ask questions about a codebase | Optional |
expand_section |
Drill into specific analysis sections | No |
read_files |
Read source files from a cached analysis | No |
find_patterns |
Detect design/architecture patterns | Yes |
trace_dataflow |
Trace data flow through the system | Yes |
get_analysis_capabilities |
List supported languages and options | No |
Analysis Layers
| 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 |
Results include expandable sections — you only pay for what you drill into.
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 analyze . -o analysis.md # Write structured markdown to file
npx codebase-analyzer-mcp analyze . -o analysis.json # Write JSON to file
npx codebase-analyzer-mcp query . "how is auth handled?" # Ask a question
npx codebase-analyzer-mcp patterns . # Find design patterns
npx codebase-analyzer-mcp dataflow . "user login" # Trace data flow
Usage with Claude Code
Dump an analysis and reference it from your CLAUDE.md:
npx codebase-analyzer-mcp analyze . -o docs/codebase-analysis.md
Then add to your project's CLAUDE.md:
## Codebase Analysis
See [docs/codebase-analysis.md](docs/codebase-analysis.md) for full analysis.
Claude Code will read the summary (~50 lines) for context, then drill into specific module sections as needed using Read with offset/limit.
Development
git clone https://github.com/jaykaycodes/codebase-analyzer-mcp.git
cd codebase-analyzer-mcp
bun install
bun run build
For local MCP testing, create .mcp.json at repo root:
{
"mcpServers": {
"codebase-analyzer": {
"command": "node",
"args": ["dist/mcp/server.js"]
}
}
}
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.