What can you do with this server?

The CodeAtlas MCP Server exposes codebase analysis data to AI assistants, enabling them to query project structure, dependencies, and AI-generated insights. * List Projects (list_projects): Discover all CodeAtlas-analyzed projects under your home directory, returning their names, paths, and last analysis timestamps. * Get Project Structure (get_project_structure): Retrieve all modules, classes, functions, and variables in a project, with optional filtering by entity type and result limits. * Get Dependencies (get_dependencies): Explore import, call, and containment relationships between entities, with filtering by source, target, and relationship type. * Get Insights (get_insights): Access AI-generated code quality insights including refactoring suggestions, security issues, and maintainability analysis. * Search Entities (search_entities): Fuzzy search for functions, classes, modules, or variables by name across a project, with optional type filtering. * Get File Entities (get_file_entities): Retrieve all classes, functions, and variables defined within a specific file using partial path matching. Compatible with major AI tools including Gemini, Claude, Cursor, Windsurf, and VS Code Copilot. Supports both npx execution and global installation.

How do I use CodeAtlas MCP Server?

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., "@CodeAtlas MCP Server show the module structure and dependencies for the current project" 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 ko ru zh

CodeAtlas MCP Server

by giauphan

Overview Schema Related Servers Score Discussions

JavaScript

Local

🗺️ CodeAtlas MCP Server

npm version License TypeScript Node

A standalone MCP server that exposes CodeAtlas analysis data to AI assistants — Gemini, Claude, Cursor, Windsurf, VS Code Copilot, and more.

NEW in v1.4.0: 🧠 AI System Memory — AI remembers your system flow between conversations.

⚡ Quick Start

1. Analyze your project

Install the CodeAtlas VS Code extension, then run:

Ctrl+Shift+P → CodeAtlas: Analyze Project

This generates .codeatlas/analysis.json in your project root.

2. Add MCP config

Pick your AI assistant and add the config:

Open Settings (Ctrl+,) → search mcp → click Edit in settings.json, then add:

{
  "mcp": {
    "servers": {
      "codeatlas": {
        "command": "npx",
        "args": ["-y", "@giauphan/codeatlas-mcp"]
      }
    }
  }
}

Or add via workspace .vscode/settings.json for per-project config.

Add to .gemini/settings.json:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Add to .windsurf/mcp.json:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

That's it! Your AI assistant can now query your codebase structure, dependencies, and insights.

🛠️ Available Tools

Code Analysis (6 tools)

Tool	Description
`list_projects`	List all analyzed projects (auto-discovers `~/`)
`get_project_structure`	Get modules, classes, functions, variables
`get_dependencies`	Get import / call / containment relationships
`get_insights`	Get AI-generated code quality insights
`search_entities`	Search functions, classes by name (fuzzy match)
`get_file_entities`	Get all entities defined in a specific file

🧠 AI System Memory (3 tools — NEW in v1.4.0)

Tool	Description
`generate_system_flow`	Auto-generate Mermaid architecture diagrams. Scopes: `modules-only`, `full`, `feature`
`sync_system_memory`	Create/update `.agents/memory/` folder — AI's persistent long-term memory
`trace_feature_flow`	Trace a feature's flow through the codebase. Returns files in dependency order

🧠 AI System Memory

AI assistants lose context between conversations. CodeAtlas MCP solves this with persistent memory files.

How it works

Conversation 1 → AI writes code → calls sync_system_memory
                                          │
                                   .agents/memory/
                                   ├── system-map.md
                                   ├── modules.json
                                   ├── business-rules.json
                                   ├── conventions.md
                                   ├── feature-flows.json
                                   └── change-log.json
                                          │
Conversation 2 → AI reads .agents/memory/ → knows full system flow instantly

Setup AI Memory

Copy rule templates to your project:

mkdir -p /path/to/your-project/.agents/rules/

Create .agents/rules/auto-memory.md with the rule that tells AI to:
- Read .agents/memory/ at the start of every conversation
- Use trace_feature_flow before making changes
- Call sync_system_memory after completing changes
Run sync_system_memory once to generate the initial memory snapshot.

📖 Full setup guide & rule templates: CodeAtlas docs

📦 Alternative: Global Install

If you prefer installing globally instead of using npx:

npm install -g @giauphan/codeatlas-mcp

Then use "command": "codeatlas-mcp" (no args needed) in your MCP config.

🔧 Environment Variables

Variable	Description
`CODEATLAS_PROJECT_DIR`	Force a specific project directory

By default, the server auto-discovers all projects with .codeatlas/analysis.json under your home directory.

🌐 Supported Languages

Language	Features
TypeScript / JavaScript	Full AST: imports, classes, functions, variables, calls
Python	Classes, functions, variables, imports, calls
PHP	Classes, interfaces, traits, enums, functions, properties, constants
Blade Templates	`@extends`, `@include`, `@component`, `<x-component>`

🧑‍💻 Development

git clone https://github.com/giauphan/codeatlas-mcp.git
cd codeatlas-mcp
npm install
npm run build
npm start

License

MIT

Install Server

security – no known vulnerabilities

license - permissive license

quality - A tier

How are these scores calculated?

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

Latest Blog Posts

Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

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/giauphan/codeatlas-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server