🗺️ CodeAtlas MCP Server

npm version License TypeScript Node

Автономный сервер MCP, который предоставляет данные анализа CodeAtlas ИИ-ассистентам — Gemini, Claude, Cursor, Windsurf, VS Code Copilot и другим.

НОВОЕ в v1.4.0: 🧠 Системная память ИИ — ИИ запоминает поток вашей системы между диалогами.

⚡ Быстрый старт

1. Проанализируйте свой проект

Установите расширение CodeAtlas для VS Code, затем выполните:

Ctrl+Shift+P → CodeAtlas: Analyze Project

Это создаст файл .codeatlas/analysis.json в корне вашего проекта.

2. Добавьте конфигурацию MCP

Выберите своего ИИ-ассистента и добавьте конфигурацию:

Откройте Настройки (Ctrl+,) → введите mcp → нажмите Edit in settings.json, затем добавьте:

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

Или добавьте через файл рабочей области .vscode/settings.json для настройки конкретного проекта.

Добавьте в .gemini/settings.json:

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

Добавьте в claude_desktop_config.json:

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

Добавьте в .cursor/mcp.json:

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

Добавьте в .windsurf/mcp.json:

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

Вот и всё! Ваш ИИ-ассистент теперь может запрашивать структуру вашей кодовой базы, зависимости и аналитические данные.

🛠️ Доступные инструменты

Анализ кода (6 инструментов)

Инструмент	Описание
`list_projects`	Список всех проанализированных проектов (автоматический поиск в `~/`)
`get_project_structure`	Получение модулей, классов, функций, переменных
`get_dependencies`	Получение связей импорта / вызовов / вложенности
`get_insights`	Получение аналитических данных о качестве кода от ИИ
`search_entities`	Поиск функций, классов по имени (нечеткий поиск)
`get_file_entities`	Получение всех сущностей, определенных в конкретном файле

🧠 Системная память ИИ (3 инструмента — НОВОЕ в v1.4.0)

Инструмент	Описание
`generate_system_flow`	Автоматическая генерация диаграмм архитектуры Mermaid. Области: `modules-only`, `full`, `feature`
`sync_system_memory`	Создание/обновление папки `.agents/memory/` — долговременная память ИИ
`trace_feature_flow`	Отслеживание потока функции через кодовую базу. Возвращает файлы в порядке зависимостей

🧠 Системная память ИИ

ИИ-ассистенты теряют контекст между диалогами. CodeAtlas MCP решает эту проблему с помощью файлов постоянной памяти.

Как это работает

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

Настройка памяти ИИ

Скопируйте шаблоны правил в свой проект:

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

Создайте .agents/rules/auto-memory.md с правилом, которое указывает ИИ:
- Читать .agents/memory/ в начале каждого диалога
- Использовать trace_feature_flow перед внесением изменений
- Вызывать sync_system_memory после завершения изменений
Запустите sync_system_memory один раз, чтобы создать начальный снимок памяти.

📖 Полное руководство по настройке и шаблоны правил: Документация CodeAtlas

📦 Альтернатива: Глобальная установка

Если вы предпочитаете глобальную установку вместо использования npx:

npm install -g @giauphan/codeatlas-mcp

Затем используйте "command": "codeatlas-mcp" (аргументы args не нужны) в вашей конфигурации MCP.

🔧 Переменные окружения

Переменная	Описание
`CODEATLAS_PROJECT_DIR`	Принудительное указание конкретной директории проекта

По умолчанию сервер автоматически обнаруживает все проекты с файлом .codeatlas/analysis.json в вашей домашней директории.

🌐 Поддерживаемые языки

Язык	Возможности
TypeScript / JavaScript	Полный AST: импорты, классы, функции, переменные, вызовы
Python	Классы, функции, переменные, импорты, вызовы
PHP	Классы, интерфейсы, трейты, перечисления, функции, свойства, константы
Blade Templates	`@extends`, `@include`, `@component`, `<x-component>`

🧑💻 Разработка

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

Лицензия

MIT

CodeAtlas MCP Server