██████╗ ██████╗ ██████╗ ███████╗ █████╗ ████████╗██╗ █████╗ ███████╗
██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔══██╗╚══██╔══╝██║ ██╔══██╗██╔════╝
██║ ██║ ██║██║ ██║█████╗ █████╗███████║ ██║ ██║ ███████║███████╗
██║ ██║ ██║██║ ██║██╔══╝ ╚════╝██╔══██║ ██║ ██║ ██╔══██║╚════██║
╚██████╗╚██████╔╝██████╔╝███████╗ ██║ ██║ ██║ ███████╗██║ ██║███████║
╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝╚══════╝
[ M C P ]
Verbinden Sie Claude Code, Claude Desktop und autonome KI-Agenten direkt mit strukturellen AST-Codekarten, token-effizienten Skeletten und PR-Blast-Radius-Auswirkungsanalysen.
Moderne LLM-Codierungsagenten verbrauchen bis zu 70 % ihres Kontextfensters für das Aufnehmen roher Dateibäume und redundanter Dateiinhalte. Bei der Änderung großer Codebasen fehlt KI-Assistenten oft die Sicht auf:
Nachgelagerte Aufrufer & Abhängigkeiten: Das Ändern einer exportierten Funktionssignatur bricht Aufrufer, die 5 Verzeichnisse entfernt liegen.
Token-Inflation: Vollständige Datei-Dumps verschwenden Kontext für Implementierungskörper statt für Typdefinitionen und Signaturen.
PR-Regressions-Blast-Radius: Fehlendes Bewusstsein darüber, welche Unit- und Integrationstestsuiten die geänderten AST-Knoten abdecken.
code-atlas-mcp löst dies, indem es eine AST-bewusste Intelligenzschicht über das standardmäßige Model Context Protocol (MCP) bereitstellt. Es parst Quelldateien in strukturelle Symbolbäume, beschneidet Funktionskörper zu token-effizienten Codeskeletten, isoliert geänderte AST-Knoten über Git-Diffs hinweg und berechnet den transitiven Regressions-Blast-Radius.
Related MCP server: MCP Filesystem Server
┌────────────────────────────────────────────────────────────────────────┐
│ AI Coding Clients │
│ (Claude Code CLI / Claude Desktop / Cursor / Custom Agents) │
└──────────────────────────────────┬─────────────────────────────────────┘
│ MCP Protocol (JSON-RPC over stdio)
▼
┌────────────────────────────────────────────────────────────────────────┐
│ code-atlas-mcp │
│ ┌───────────────────────────────┬──────────────────────────────────┐ │
│ │ MCP Request Router │ Tool Schema Validators │ │
│ │ (ListTools / CallTool Handler)│ (Zod Runtime) │ │
│ └───────────────┬───────────────┴──────────────────┬───────────────┘ │
│ ▼ ▼ │
│ ┌───────────────────────────────┐ ┌───────────────────────────────┐ │
│ │ AST Engine │ │ Git Engine │ │
│ │ • TypeScript Compiler API │ │ • Unified Diff Parser │ │
│ │ • Symbol & Hierarchy Extr. │ │ • Line-to-AST Correlation │ │
│ │ • Token-Efficient Skeletons │ │ • Working Tree / Ref Diffs │ │
│ └───────────────┬───────────────┘ └───────────────┬───────────────┘ │
│ └───────────────┬──────────────────┘ │
│ ▼ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ Impact Analyzer │ │
│ │ • Downstream Callers Graph • Transitive Dependency BFS │ │
│ │ • Test Suite Coverage Map • Risk Scoring & Assessment Engine │ │
│ └──────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────┬─────────────────────────────────────┘
▼
┌────────────────────────────────────────────────────────────────────────┐
│ Local Codebase │
│ Filesystem (.ts, .tsx, .js, .jsx) & .git │
└────────────────────────────────────────────────────────────────────────┘get_repo_structureGibt eine hierarchische, AST-beschnittene Strukturkarte des Repositorys mit optionalen token-effizienten Codeskeletten zurück. Entfernt Funktionskörper, während vollständige Signaturen, exportierte Schnittstellen, Typen und Docstrings erhalten bleiben.
Parameter | Typ | Erforderlich | Beschreibung | Standard |
|
| Nein | Ziel-Repository-Verzeichnis. | Aktuelles Arbeitsverzeichnis |
|
| Nein | Token-effiziente Codeskelette mit entfernten Funktionskörpern erzeugen. |
|
|
| Nein | Maximale Verzeichnis-Tiefe (1-20). |
|
|
| Nein | Array von Ordner-/Datei-Glob-Mustern zum Ignorieren. |
|
|
| Nein | Array erlaubter Erweiterungen (z. B. | Standard TS/JS |
{
"rootDir": "/workspace/my-app",
"totalFiles": 42,
"totalSymbols": 318,
"fileTree": {
"name": "src",
"type": "directory",
"children": [
{
"name": "auth.ts",
"type": "file",
"symbolsCount": 4,
"summary": {
"language": "typescript",
"linesOfCode": 120,
"symbols": [
{
"name": "verifyJwt",
"kind": "function",
"signature": "export function verifyJwt(token: string): Promise<JwtPayload>",
"startLine": 15,
"endLine": 42,
"isExported": true
}
],
"astSkeleton": "import { JwtPayload } from \"./types.js\";\n\nexport function verifyJwt(token: string): Promise<JwtPayload>;"
}
}
]
}
}analyze_diff_impactAnalysiert geänderte AST-Knoten zwischen Branches, Commits oder dem uncommitteten Arbeitsbaum, um betroffene nachgelagerte Funktionen, Klassen und Komponenten zu bestimmen.
Parameter | Typ | Erforderlich | Beschreibung | Standard |
|
| Nein | Basis-Git-Revision oder Branch (z. B. | Uncommitteter Arbeitsbaum |
|
| Nein | Head-Git-Revision oder Branch (z. B. | Zustand des Arbeitsbaums |
|
| Nein | Pfad zum Git-Repository-Root. | Aktuelles Arbeitsverzeichnis |
{
"baseRef": "main",
"headRef": "HEAD",
"changedFilesCount": 2,
"modifiedFiles": ["src/auth/jwt.ts"],
"modifiedAstNodes": [
{
"filePath": "src/auth/jwt.ts",
"symbol": {
"name": "verifyJwt",
"kind": "function",
"signature": "export function verifyJwt(token: string, options?: VerifyOptions): Promise<JwtPayload>",
"startLine": 12,
"endLine": 35,
"isExported": true
},
"changeType": "modified",
"modifiedLines": [12, 13, 14]
}
],
"affectedDownstream": [
{
"symbolName": "verifyJwt",
"sourceFile": "src/auth/jwt.ts",
"dependentFile": "src/middleware/auth.ts",
"impactType": "direct_import",
"reason": "File 'src/middleware/auth.ts' directly imports symbol 'verifyJwt' modified in 'src/auth/jwt.ts'"
}
],
"summary": "Diff Impact Analysis: 1 file(s) modified across 1 distinct AST symbol(s). Identified 1 downstream dependent reference(s) that require verification."
}inspect_blast_radiusIdentifiziert potenzielle Regressionspunkte, transitive nachgelagerte Abhängigkeiten (BFS-Traversierung) und fehlerhafte Testsuiten für eine gezielte Dateiänderung. Berechnet einen Risikowert von 0-100 mit kritischen Faktoren.
Parameter | Typ | Erforderlich | Beschreibung | Standard |
|
| Ja | Pfad zur Ziel-Quelldatei (z. B. | — |
|
| Nein | Pfad zum Repository-Root. | Aktuelles Arbeitsverzeichnis |
{
"targetFile": "src/services/user.ts",
"targetSymbols": [ /* AST Symbols */ ],
"directDependents": [
{
"filePath": "src/controllers/auth.ts",
"importedSymbols": ["getUserById", "updateUser"]
}
],
"transitiveDependents": [
{
"filePath": "src/routes/api.ts",
"depth": 2,
"chain": ["src/services/user.ts", "src/controllers/auth.ts", "src/routes/api.ts"]
}
],
"affectedSuites": [
{
"testFile": "tests/auth.test.ts",
"reliesOn": ["src/services/user.ts", "src/controllers/auth.ts"],
"riskLevel": "HIGH",
"potentialFailures": ["getUserById", "updateUser"]
}
],
"riskAssessment": {
"score": 65,
"level": "HIGH",
"factors": [
"Exports 4 symbol(s)",
"High direct coupling: 3 direct dependent files",
"Moderate cascade: 5 transitive dependents",
"1 test suite(s) actively verify dependent code"
]
}
}npm install -g code-atlas-mcpnpx code-atlas-mcp --root /path/to/your/projectFügen Sie code-atlas-mcp zu Ihrer claude_desktop_config.json hinzu:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"code-atlas": {
"command": "npx",
"args": [
"-y",
"code-atlas-mcp"
]
}
}
}Wenn Sie ein bestimmtes Repository-Verzeichnis festlegen möchten:
{
"mcpServers": {
"code-atlas": {
"command": "npx",
"args": [
"-y",
"code-atlas-mcp",
"--root",
"/absolute/path/to/your/repository"
]
}
}
}Starten Sie claude mit dem angehängten MCP-Server:
claude --mcp-server "npx -y code-atlas-mcp"Node.js >= 18.0.0
npm >= 9.0.0
Git CLI
# Clone the repository
git clone https://github.com/GeorgeTsakonas/code-atlas-mcp.git
cd code-atlas-mcp
# Install dependencies
npm install
# Build TypeScript to dist/
npm run build
# Run unit and integration tests with Vitest
npm test
# Run tests in watch mode
npm run test:watch
# Type check
npm run lintTypeScript-Compiler-API-AST-Extraktion
Token-effiziente Skelettgenerierung (entfernte Körper)
Git-Diff-Zeilen-zu-AST-Knoten-Korrelation
Nachgelagerte Abhängigkeitsgraph- & Aufrufstellen-Auswirkungsanalyse
Transitive Blast-Radius-Inspektion & Testsuiten-Identifikation
MCP-Standard-stdio-Transport
Python-AST-Parser-Engine-Unterstützung (ast / Tree-sitter)
Rust- und Go-AST-Parsing-Module
Semantische Vektorsuche über AST-Symbole
Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.
Forken Sie das Projekt
Erstellen Sie Ihren Feature-Branch (git checkout -b feature/AmazingFeature)
Committen Sie Ihre Änderungen (git commit -m 'Add some AmazingFeature')
Pushen Sie den Branch (git push origin feature/AmazingFeature)
Öffnen Sie einen Pull Request
Verteilt unter der MIT-Lizenz. Siehe LICENSE für weitere Informationen.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Deterministic context layer for your codebase: change impact, blast radius, answers with receipts.
Give your AI agent a persistent map of your project's structure, dependencies, and bugs.
Codebase intelligence for agents: 152 structured artifacts across 21 programs, one call.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/GeorgeTsakonas/code-atlas-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server