██████╗ ██████╗ ██████╗ ███████╗ █████╗ ████████╗██╗ █████╗ ███████╗
██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔══██╗╚══██╔══╝██║ ██╔══██╗██╔════╝
██║ ██║ ██║██║ ██║█████╗ █████╗███████║ ██║ ██║ ███████║███████╗
██║ ██║ ██║██║ ██║██╔══╝ ╚════╝██╔══██║ ██║ ██║ ██╔══██║╚════██║
╚██████╗╚██████╔╝██████╔╝███████╗ ██║ ██║ ██║ ███████╗██║ ██║███████║
╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝╚══════╝
[ M C P ]
Conecta Claude Code, Claude Desktop y Agentes de IA Autónomos directamente a mapas de código AST estructurales, esqueletos eficientes en tokens y análisis de impacto de radio de explosión de PR.
Los agentes de codificación LLM modernos gastan hasta el 70% de su ventana de contexto ingiriendo árboles de archivos sin procesar y contenidos de archivos redundantes. Al modificar bases de código grandes, los asistentes de IA a menudo carecen de visibilidad sobre:
Llamadores y dependientes posteriores: Modificar la firma de una función exportada rompe a los llamadores a 5 directorios de distancia.
Inflación de tokens: Los volcados de archivos completos desperdician contexto en cuerpos de implementación en lugar de definiciones de tipos y firmas.
Radio de explosión de regresión de PR: Falta de conciencia sobre qué suites de pruebas unitarias y de integración cubren los nodos AST modificados.
code-atlas-mcp resuelve esto exponiendo una capa de inteligencia consciente de AST a través del estándar Model Context Protocol (MCP). Analiza archivos fuente en árboles de símbolos estructurales, poda cuerpos de funciones en esqueletos de código eficientes en tokens, aísla nodos AST modificados en diffs de git y calcula el radio de explosión de regresión transitiva.
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_structureDevuelve un mapa estructural jerárquico y podado por AST del repositorio con esqueletos de código opcionales eficientes en tokens. Elimina los cuerpos de las funciones mientras conserva firmas completas, interfaces exportadas, tipos y docstrings.
Parámetro | Tipo | Requerido | Descripción | Por defecto |
|
| No | Directorio del repositorio objetivo. | Directorio de trabajo actual |
|
| No | Generar esqueletos de código eficientes en tokens con cuerpos de funciones eliminados. |
|
|
| No | Profundidad máxima de recorrido de directorios (1-20). |
|
|
| No | Matriz de patrones glob de carpetas/archivos a ignorar. |
|
|
| No | Matriz de extensiones permitidas (p. ej. | TS/JS estándar |
{
"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_impactAnaliza los nodos AST modificados entre ramas, confirmaciones o el árbol de trabajo sin confirmar para determinar las funciones, clases y componentes posteriores afectados.
Parámetro | Tipo | Requerido | Descripción | Por defecto |
|
| No | Revisión o rama base de git (p. ej. | Árbol de trabajo sin confirmar |
|
| No | Revisión o rama de git head (p. ej. | Estado del árbol de trabajo |
|
| No | Ruta a la raíz del repositorio git. | Directorio de trabajo actual |
{
"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_radiusIdentifica posibles puntos de regresión, dependientes posteriores transitivos (recorrido BFS) y suites de pruebas rotas para un cambio de archivo específico. Calcula una puntuación de riesgo de 0 a 100 con factores críticos.
Parámetro | Tipo | Requerido | Descripción | Por defecto |
|
| Sí | Ruta al archivo fuente objetivo (p. ej. | — |
|
| No | Ruta a la raíz del repositorio. | Directorio de trabajo actual |
{
"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/projectAñade code-atlas-mcp a tu claude_desktop_config.json:
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"
]
}
}
}Si deseas fijar un directorio de repositorio específico:
{
"mcpServers": {
"code-atlas": {
"command": "npx",
"args": [
"-y",
"code-atlas-mcp",
"--root",
"/absolute/path/to/your/repository"
]
}
}
}Lanza claude con el servidor MCP adjunto:
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 lintExtracción de AST de TypeScript Compiler API
Generación de esqueletos eficientes en tokens (cuerpos eliminados)
Correlación de líneas de diff de git con nodos AST
Grafo de dependencias posteriores y análisis de impacto en sitios de llamada
Inspección de radio de explosión transitiva e identificación de suites de pruebas
Transporte stdio estándar de MCP
Soporte del motor de análisis AST de Python (ast / Tree-sitter)
Módulos de análisis AST de Rust y Go
Búsqueda semántica vectorial sobre símbolos AST
¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.
Haz un fork del proyecto
Crea tu rama de características (git checkout -b feature/AmazingFeature)
Confirma tus cambios (git commit -m 'Add some AmazingFeature')
Sube a la rama (git push origin feature/AmazingFeature)
Abre un Pull Request
Distribuido bajo la Licencia MIT. Consulta LICENSE para obtener más información.
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