How do I use code-atlas-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@code-atlas-mcp What files are impacted by my current branch changes?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

code-atlas-mcp

by GeorgeTsakonas

Overview Schema Related Servers Score Discussions

TypeScript

Local

  ██████╗ ██████╗ ██████╗ ███████╗      █████╗ ████████╗██╗      █████╗ ███████╗
 ██╔════╝██╔═══██╗██╔══██╗██╔════╝     ██╔══██╗╚══██╔══╝██║     ██╔══██╗██╔════╝
 ██║     ██║   ██║██║  ██║█████╗ █████╗███████║   ██║   ██║     ███████║███████╗
 ██║     ██║   ██║██║  ██║██╔══╝ ╚════╝██╔══██║   ██║   ██║     ██╔══██║╚════██║
 ╚██████╗╚██████╔╝██████╔╝███████╗     ██║  ██║   ██║   ███████╗██║  ██║███████║
  ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝     ╚═╝  ╚═╝   ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝
                                 [ M C P ]

High-Performance AST-Aware Model Context Protocol Server

License: MIT TypeScript Node.js MCP Standard Vitest

Connect Claude Code, Claude Desktop, and Autonomous AI Agents directly to structural AST code maps, token-efficient skeletons, and PR blast-radius impact analysis.

📖 Overview

Modern LLM coding agents spend up to 70% of their context window ingesting raw file trees and redundant file contents. When modifying large codebases, AI assistants often lack visibility into:

Downstream Callers & Dependents: Modifying an exported function signature breaks callers 5 directories away.
Token Inflation: Full-file dumps waste context on implementation bodies instead of type definitions and signatures.
PR Regression Blast Radius: Lack of awareness about which unit and integration test suites cover the modified AST nodes.

code-atlas-mcp solves this by exposing an AST-aware intelligence layer via the standard Model Context Protocol (MCP). It parses source files into structural symbol trees, prunes function bodies into token-efficient code skeletons, isolates modified AST nodes across git diffs, and computes transitive regression blast radius.

Related MCP server: MCP Filesystem Server

🏛️ Architecture

┌────────────────────────────────────────────────────────────────────────┐
│                        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                 │
└────────────────────────────────────────────────────────────────────────┘

⚡ Core MCP Tools

1. `get_repo_structure`

Returns a hierarchical, AST-pruned structural map of the repository with optional token-efficient code skeletons. Strips function bodies while preserving complete signatures, exported interfaces, types, and docstrings.

Parameters

Parameter	Type	Required	Description	Default
`rootDir`	`string`	No	Target repository directory.	Current working directory
`includeSkeletons`	`boolean`	No	Generate token-efficient code skeletons with stripped function bodies.	`true`
`maxDepth`	`number`	No	Maximum directory traversal depth (1-20).	`5`
`ignorePatterns`	`string[]`	No	Array of folder/file glob patterns to ignore.	`[]`
`fileExtensions`	`string[]`	No	Array of allowed extensions (e.g. `['.ts', '.tsx']`).	Standard TS/JS

Example Tool Output

{
  "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>;"
        }
      }
    ]
  }
}

2. `analyze_diff_impact`

Analyzes modified AST nodes between branches, commits, or the uncommitted working tree to determine affected downstream functions, classes, and components.

Parameters

Parameter	Type	Required	Description	Default
`baseRef`	`string`	No	Base git revision or branch (e.g. `'main'`, `'HEAD~1'`).	Uncommitted working tree
`headRef`	`string`	No	Head git revision or branch (e.g. `'feature-auth'`, `'HEAD'`).	Working tree state
`repoPath`	`string`	No	Path to git repository root.	Current working directory

Example Tool Output

{
  "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."
}

3. `inspect_blast_radius`

Identifies potential regression points, transitive downstream dependents (BFS traversal), and broken test suites for a targeted file change. Calculates a 0-100 risk score with critical factors.

Parameters

Parameter	Type	Required	Description	Default
`targetFile`	`string`	Yes	Path to the target source file (e.g. `'src/services/ast-engine.ts'`).	—
`repoPath`	`string`	No	Path to repository root.	Current working directory

Example Tool Output

{
  "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"
    ]
  }
}

🚀 Installation & Quick Start

Global CLI Installation

npm install -g code-atlas-mcp

Run Directly via NPX

npx code-atlas-mcp --root /path/to/your/project

🤖 Claude Integration Configuration

Claude Desktop Setup

Add code-atlas-mcp to your 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"
      ]
    }
  }
}

If you want to pin a specific repository directory:

{
  "mcpServers": {
    "code-atlas": {
      "command": "npx",
      "args": [
        "-y",
        "code-atlas-mcp",
        "--root",
        "/absolute/path/to/your/repository"
      ]
    }
  }
}

Claude Code CLI Setup

Launch claude with the MCP server attached:

claude --mcp-server "npx -y code-atlas-mcp"

🛠️ Development & Testing

Prerequisites

Node.js >= 18.0.0
npm >= 9.0.0
Git CLI

Setup

# 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 lint

🗺️ Roadmap

TypeScript Compiler API AST extraction
Token-efficient skeleton generation (stripped bodies)
Git diff line-to-AST node correlation
Downstream dependency graph & call-site impact analysis
Transitive blast-radius inspection & test suite identification
MCP Standard stdio transport
Python AST parser engine support (ast / Tree-sitter)
Rust and Go AST parsing modules
Semantic vector search over AST symbols

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

XRAY MCP
Code Analysis Developer Tools
srijanshukla18
A
license
A
quality
D
maintenance
Enables AI assistants to understand and navigate codebases through structural analysis. Provides code mapping, symbol search, and impact analysis using ast-grep for accurate parsing of Python, JavaScript, TypeScript, and Go projects.
Updated 9 months ago (2025-12-11 12:41 UTC)
4
52
MIT
MCP Filesystem Server
Code Analysis Developer Tools File Systems
williamRR
A
license
Not graded
quality
D
maintenance
Provides LLM-optimized tools for advanced code analysis, repository complexity evaluation, and call graph generation. It enables users to visualize directory structures, detect code patterns, and build semantic context with significant token savings.
Updated 5 months ago (2026-04-09 08:56 UTC)
11
MIT
mcp-repo-graph
Developer Tools Knowledge & Memory RAG Systems
James-Chahwan
A
license
A
quality
C
maintenance
Structural graph map of any codebase. Scans entities, relationships, and feature flows across 13 languages so LLMs navigate by structure instead of reading everything.
Updated 2 months ago (2026-07-08 14:10 UTC)
6
14
MIT
mcp-code-context
Developer Tools Code Analysis
achatainga
A
license
B
quality
A
maintenance
Enables LLMs to efficiently read, write, and refactor code using precise AST-based operations, reducing token usage and context window waste.
Updated a month ago (2026-07-17 21:47 UTC)
25
57
3
MIT

View all related MCP servers

Related MCP Connectors

Spiderbrain
Deterministic context layer for your codebase: change impact, blast radius, answers with receipts.
Umtri
Give your AI agent a persistent map of your project's structure, dependencies, and bugs.
Axis Iliad — Codebase Intelligence For Agentic Commerce
Codebase intelligence for agents: 152 structured artifacts across 21 programs, one call.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

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

High-Performance AST-Aware Model Context Protocol Server

📖 Overview

🏛️ Architecture

⚡ Core MCP Tools

1. get_repo_structure

Parameters

Example Tool Output

2. analyze_diff_impact

Parameters

Example Tool Output

3. inspect_blast_radius

Parameters

Example Tool Output

🚀 Installation & Quick Start

Global CLI Installation

Run Directly via NPX

🤖 Claude Integration Configuration

Claude Desktop Setup

Claude Code CLI Setup

🛠️ Development & Testing

Prerequisites

Setup

🗺️ Roadmap

🤝 Contributing

📄 License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

XRAY MCP

MCP Filesystem Server

mcp-repo-graph

mcp-code-context

Related MCP Connectors

Latest Blog Posts

MCP directory API

1. `get_repo_structure`

2. `analyze_diff_impact`

3. `inspect_blast_radius`