MSCodebase Intelligence

ИИ-семантический поиск кода для Zed IDE — MCP-сервер глубокого анализа кода

Возможности • Быстрый старт • Инструменты • Документация • Установка • Архитектура • Участие • Безопасность

Последнее обновление: 2026-07-12

🎯 Позиционирование

MSCodeBase Intelligence — это MCP-сервер для Zed IDE, который предоставляет AI-ассистентам глубокое понимание всей кодовой базы: семантический поиск, граф вызовов, память проекта, диагностика.

Это не LSP-сервер и не замена встроенному автодополнению редактора. Это слой «кодового интеллекта» поверх редактора:

┌─────────────────────────────────────────────────────┐
│                      Zed IDE                         │
│  ┌───────────────────────────────────────────────┐  │
│  │        LSP (встроенное автодополнение,        │  │
│  │        подсказки в строке, диагностика)        │  │
│  └───────────────────────────────────────────────┘  │
│                        │                              │
│                        ▼                              │
│  ┌───────────────────────────────────────────────┐  │
│  │  MSCodeBase (MCP-сервер)                     │  │
│  │  · Семантический поиск по кодовой базе        │  │
│  │  · Граф вызовов и анализ влияния              │  │
│  │  · Память проекта (ADR, техдолг)              │  │
│  │  · Самодиагностика и самовосстановление       │  │
│  │  · 59 инструментов для AI-ассистента          │  │
│  └───────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────┘

Что вы получаете

Возможность	MSCodeBase	Стандартный LSP (pyright/pylsp)
🔍 Семантический поиск (BM25 + Vector + Reranker)	✅	❌
🧠 Граф вызовов + анализ влияния	✅	❌
🗃️ Память проекта (ADR, известные проблемы)	✅	❌
🏥 Самодиагностика + самовосстановление	✅	❌
🔎 Кросс-репозиторный поиск	✅	❌
🤖 Генерация ответов RAG (mode=ask)	✅	❌
✏️ Встроенное автодополнение	❌	✅
🏷️ Подсказки в строке (inlay hints)	❌	✅

LSP: только для rename (гибридный режим)

MSCodeBase использует LSP только для rename_symbol — LSP-клиент (src/core/lsp_client.py) запускает pyright-langserver для точного rename между файлами, с автоматическим fallback на SymbolIndex (Tree-sitter) при таймауте. Вся остальная функциональность реализована через 59 MCP-инструментов.

Отдельный LSP-сервер (src/lsp_main.py) был экспериментальным и не работает в Zed — см. LSP_WONTFIX.md.

Платформы

Спроектирован и протестирован на Windows. macOS и Linux должны работать, но официально не валидированы.

Языки

Язык	Парсинг	Граф вызовов	Data Flow (ASSIGNED_FROM)
Python	✅	✅	✅
TypeScript	✅	✅	✅
TSX	✅	✅	✅
Rust	✅	✅	✅
Go	✅	✅	✅
JavaScript	✅	✅	✅
Java	✅	✅	✅
C#	✅	✅	✅
Ruby	✅	✅	✅
PHP	✅	✅	✅
Kotlin	✅	✅	✅
Swift	✅	✅	✅
C	✅	✅	✅
C++	✅	✅	✅
Scala	✅	✅	✅
Dart	✅	✅	✅

✨ Возможности

Возможность	Описание
🔍 Унифицированный поиск	`search_code(query, mode, intent_hint)` — единый инструмент: fast/quality/deep/context/ask/auto
🧠 Интеллектуальный слой	14 высокоуровневых инструментов `intel_*`: самодиагностика, топология, память, предсказание ошибок
🗃️ Память проекта	ADR, известные проблемы, технический долг — автоматически сохраняется между сессиями
🌐 Кросс-репозиторный поиск	Поиск по нескольким проектам с синтаксисом `@mention`
🌳 Граф вызовов	Полный граф вызовов: определение + вызывающие + вызываемые + анализ влияния
🏗 Структурный поиск	13 AST-паттернов (class_inheritance, async_function, decorator и др.)
🔎 Контекстный поиск	Поиск похожего кода — вставьте фрагмент, получите семантические дубликаты
🪣 Мульти-бакетный RAG	Бакеты кода/документации, мягкое взвешивание, intent_hint (code/docs/auto)
🤖 mode=ask	Генерация ответов RAG через phi-4 (профиль server)
💾 LanceDB v2	Векторная БД с изоляцией по проектам (инкрементальный BM25-реиндекс)
🛡 Ограничение запросов	DebounceBatch + CircuitBreaker — защита от VFS-циклов
🏥 Самодиагностика	`get_health_report` + `index_health` — полная проверка и восстановление
🧪 Чистая архитектура	DI-контейнер (15+ сервисов), 59 инструментов (41 на классах + 14 intel + 3 diag), 494+ теста
🔗 Граф потока данных	Рёбра `ASSIGNED_FROM` отслеживают присваивания. Unified Walker + Conditional Flow (if/for/while/try). 3,337 рёбер на MSCodeBase (81% условных).
🪟 Мульти-оконность	`ProjectIndexerRegistry` — изолированный Indexer на проект, LRU 5, ResourceMonitor throttle
✏️ Write Tools	6 инструментов: rename/move/delete/replace символов с preview/apply + `@modification_guard`
⚡ Meta-Patching	LanceDB `move_chunks_metadata` — file_path rename без пере-эмбеддинга (50ms против 5s)
⚙️ SYSTEM_PROFILE	`light` (синхронный) / `server` (асинхронный с phi-4)

🚀 Быстрый старт

Установите расширение mscodebase-intelligence в Zed, затем:

cd D:\Project\MSCodeBase
python install.py

# Перезапустите Zed (File → Quit → reopen)
# Проверьте: intel_get_runtime_status()

install.py выполняет:

Копирует 39+ файлов исходников в директорию расширения
Устанавливает Python-зависимости
Скачивает llama-server.exe (reranker) + модель E5-base-v2 (ONNX, CPU)
Настраивает MCP в settings.json Zed

См. также: AI_INSTALLATION_PROMPT.md, INSTALL.md

Провайдеры

MCP использует E5-base-v2 (ONNX, CPU, in-process) для эмбеддингов и llama-server для реранкера:

E5-base ONNX (CPU, in-process) → llama-server reranker
   ~265 MB RAM                 ~1.0 GB RAM
   360 i/s                     1 процесс

Бенчмарки: ../../docs/research/2026-07-10-final-benchmark.md

📚 Карта документации

Документ	Описание	Аудитория	Языки
INSTALL.md	Установка, настройка, удаление	Пользователи	🇬🇧 🇷🇺 🇨🇳
ARCHITECTURE.md	Чистая архитектура, слои, DI	Разработчики	🇬🇧 🇷🇺 🇨🇳
ARCHITECTURE_DEEP.md	Глубокая архитектура: pipeline, lifecycle, сравнение	Архитекторы	🇬🇧 🇷🇺 🇨🇳
SEARCH_PIPELINE.md	Пайплайн поиска: BM25 → RRF → Reranker	Разработчики	🇬🇧
GRACEFUL_DEGRADATION.md	5 уровней плавной деградации (llama.cpp → ONNX → BM25)	DevOps	🇬🇧
ARCHITECTURE_LAYERS.md	10 слоев рантайма	Архитекторы	🇬🇧 🇷🇺 🇨🇳
FAQ.md	Часто задаваемые вопросы	Все	🇬🇧 🇷🇺 🇨🇳
TELEMETRY.md	Метрики, ETA, сбор данных	DevOps	🇬🇧 🇷🇺 🇨🇳
investigations/ONNX_SESSION_REPORT.md	Полная миграция ONNX, 7 исправлений, бенчмарки	Поддержка	🇬🇧
investigations/LSP_WONTFIX.md	Исследование LSP на Windows (WONTFIX)	Поддержка	🇬🇧 🇨🇳
ZED_WINDOWS_QUIRKS.md	Особенности Windows, Restricted Mode	Пользователи Windows	🇬🇧 🇷🇺 🇨🇳
CHANGELOG.md	История версий	Все	🇬🇧 🇷🇺 🇨🇳
CONTRIBUTING.md	Как внести вклад, PR	Контрибьюторы	🇬🇧 🇷🇺 🇨🇳
SECURITY.md	Политика безопасности, уязвимости	Безопасность	🇬🇧 🇷🇺 🇨🇳
../../AGENTS.md	Системные правила AI-агента	AI-агент	🇬🇧
../../SECURITY.md	Политика безопасности, сообщение об уязвимостях	Безопасность	🇬🇧
../../CODE_OF_CONDUCT.md	Стандарты сообщества	Контрибьюторы	🇬🇧

| ../../docs/KNOWN_ISSUES.md | Известные проблемы и реестр техдолга | Все | 🇬🇧 |

Все документы перекрёстно ссылаются друг на друга. Доступны на 3 языках: English, Русский, 中文.

MCP Инструменты (59 всего)

Основной поиск

Инструмент	Когда использовать
`search_code(query, mode, filter_layer, intent_hint)`	Главный инструмент поиска. `mode="auto"` / `"fast"` / `"quality"` / `"deep"` / `"context"` / `"ask"`. `intent_hint="code"` / `"docs"` / `"auto"` — мягкое взвешивание бакетов. `filter_layer="core"` — поиск в конкретном архитектурном слое
`structural_search(pattern)`	AST-поиск: `class_inheritance`, `async_function`, `function_with_decorator` и другие
`cross_repo_search(query @repo)`	Поиск по нескольким проектам (моно-репозиторий)
`cross_project_deps(action)`	Граф зависимостей между проектами: `graph` / `deps` / `cycles` / `impact`
`get_symbol_info(query)`	Граф вызовов: вызывающие, вызываемые, затрагиваемые файлы
`impact_analysis(symbol)`	Анализ влияния изменений символа (оценка риска, глубина)

Управление индексом

Инструмент	Когда использовать
`get_index_status()`	Статус индекса: чанки, файлы, символы
`get_index_progress()`	Прогресс индексации (фаза, проценты)
`index_project_dir(path)`	Запустить полную индексацию проекта
`get_index_timeline()`	История индексации по датам
`index_health(project_root)`	Диагностика индекса и самовосстановление
`notify_change(file_path)`	Принудительное обновление индекса для файла (через DebounceBatch)
`generate_chunk_summaries(root)`	LLM-генерированные описания для чанков кода
`scan_changes(project_root)`	Архитектурный diff — анализ изменений с последнего baseline

Система и диагностика

Инструмент	Когда использовать
`get_health_report()`	Полная самодиагностика: индекс, эмбеддер, логи, синхронизация
`watcher_status()`	Статус компонентов: режим эмбеддера, индексация, здоровье
`get_logs(project_root)`	Последние ошибки и предупреждения из логов проекта
`get_repo_map(project_root)`	Карта проекта: дерево файлов + ключевые символы
`read_live_file(path)`	Чтение файла из памяти LSP (включая несохранённые изменения)
`predict_eta(operation)`	Прогнозирование длительности операции на основе истории
`run_health_check()`	Полная проверка здоровья проекта (тесты + git + индекс)

Аналитика

Инструмент	Когда использовать
`get_hotspots(project_root)`	Горячие точки — файлы с высоким уровнем багов
`get_repo_rank(project_root, top_k)`	Ранжирование важностей символов (PageRank на графе вызовов)
`get_bug_correlation(project_root)`	Анализ корреляции багов и изменений
`get_related_files(project_root, path)`	Файлы, связанные через совместные изменения / корреляцию багов
`graph_query(query_type, target)`	Запросы к графу знаний: `impact` / `feature` / `deps` / `tests`
`find_similar_bugs(error)`	Поиск похожих багов из истории по тексту ошибки

Git и история

Инструмент	Когда использовать
`get_commit_history(root, limit)`	Семантическая история коммитов
`get_file_history(root, path)`	История изменений конкретного файла
`get_branch_info(project_root)`	Информация о ветке + статус индекса

Жизненный цикл и верификация

Инструмент	Когда использовать
`submit_background_task(type, root)`	Запуск долгих задач: `bug_correlation` / `build_knowledge_graph` / `full_analysis`
`get_task_status(task_id)`	Статус фоновой задачи
`verify_action(action_type)`	Верификация: `file_write` / `git_commit` / `git_push` / `index_sync`

Write Tools (7)

Инструмент	Когда использовать
`rename_symbol(old, new, apply)`	Переименование символа во всех файлах (preview/apply, проверка коллизий)
`move_symbol(symbol, to_file, apply)`	Перемещение символа в другой файл (preview/apply, обновление импортов)
`safe_delete(symbol, force, apply)`	Безопасное удаление с проверкой ссылок (force mode)
`replace_symbol(symbol, new_code, apply)`	Замена тела функции/класса (preview/apply)
`insert_before_symbol(anchor, new_code, apply)`	Вставка кода перед anchor-символом (preview/apply)
`insert_after_symbol(anchor, new_code, apply)`	Вставка кода после тела anchor (preview/apply)
`ack_impact(file_path)`	Подтверждение влияния для modification guard

Интеллектуальный слой (intel_*) — 14 высокоуровневых инструментов

Инструмент	Назначение
`intel_get_runtime_status()`	Агрегированный статус здоровья: эмбеддер, индекс, использование ресурсов
`intel_trigger_reindex()`	Реиндексация без ожидания (не блокирует Zed)
`intel_get_job_status(job_id)`	Прогресс фоновой задачи
`intel_code_topology(symbol)`	Граф вызовов + топология модулей (< 2 сек)
`intel_get_project_memory()`	Карта памяти проекта: ADR, known_issues, tech_debt
`intel_log_incident(...)`	Запись инцидента в историю проекта
`intel_analyze_incident(error)`	Поиск похожих инцидентов + готовые решения
`intel_add_memory_node(section, data)`	Добавление записи в память проекта
`intel_get_hotspots()`	Топ-5 файлов с наибольшей баг-нагрузкой
`intel_predict_root_cause(error)`	Предсказание первопричины по логам + истории
`intel_get_telemetry(days)`	Поинструментальная телеметрия, использование ресурсов, статистика LLM
`intel_tool_health()`	Процент успеха инструментов, задержки, уверенность
`intel_explain_project_state(root)`	Человекочитаемый диагноз состояния проекта
`intel_get_project_context(root)`	Единый снэпшот: состояние, индекс, здоровье, память

Диагностические инструменты (3)

Инструмент	Назначение
`debug_runtime_passport()`	Паспорт процесса: RUN_ID, PID, информация о сборке
`get_runtime_counters()`	Счётчики рантайма: вызовы, блокировки, предупреждения
`intel_execution_timeline(limit)`	Лента последних действий с длительностью

🏗️ Архитектура

Чистая архитектура с DI-контейнером

┌──────────────────────────────────────────────────────────────────┐
│                   MCP Server (~220 строк)                         │
│            src/mcp/server.py — только регистрация                │
│                                                                  │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │              DI Container (15 сервисов)                    │   │
│  │  src/core/di_container.py — ServiceCollection              │   │
│  │                                                           │   │
│  │  ┌──────────┐  ┌────────────┐  ┌──────────────────────┐  │   │
│  │  │ Indexer  │  │  Searcher  │  │  DebounceBatch       │  │   │
│  │  │ Embedder │  │  SymbolIdx │  │  CircuitBreaker      │  │   │
│  │  │ Parser   │  │  FileGuard │  │  RateLimiter         │  │   │
│  │  └──────────┘  └────────────┘  └──────────────────────┘  │   │
│  └──────────────────────────────────────────────────────────┘   │
│                           │                                       │
│              ┌────────────┴────────────┐                         │
│              ▼                          ▼                         │
│  ┌────────────────────┐  ┌────────────────────────────────────┐  │
│  │  33 Класса         │  │  14 intel_* + 3 diag             │  │
│  │  │  src/mcp/tools/*.py │  │  src/core/intelligence_layer.py    │  │
│  │  │  Один класс на       │  │  decorator error_boundary         │
│  │  │  инструмент          │  │  JSON status/message/detail       │
│  │  │  Constructor Inj.   │  │  asyncio.wait_for(timeout)        │  │
│  │  │  Constructor Inj.   │  │                                    │  │
│  │  └────────────────────┘  └────────────────────────────────────┘  │
│  └──────────────────────────────────────────────────────────────────┘
│         │
│         ▼
│  ┌─────────────────┐     ┌───────────────────┐
│  │  RemoteEmbedder  │     │  LanceDB v2       │
│  │  (ONNX E5-base,  │     │  (Vector DB)       │
│  │   CPU, in-process)│     │  BM25 + Vector    │
│  └─────────────────┘     └───────────────────┘

⚡ Производительность

Режим	Задержка	Лучше всего для
`search_code(query, mode="fast")`	~300ms	Простой ключевой слова / точное имя
`search_code(query, mode="quality")`	~1200ms	Семантический поиск с реранкером
`search_code(query, mode="deep")`	~2-5s	Сложное исследование по модулям
`search_code(query, mode="context")`	~500ms	Поиск похожего кода по фрагменту
`cross_repo_search(query @repo)`	~500ms-2s	Кросс-проектный поиск

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

Переменная	Значение по умолчанию	Описание
`LM_STUDIO_URL`	`http://localhost:1234/v1`	API-ендпоинт LM Studio
`LM_STUDIO_PORT`	`1234`	Порт LM Studio
`OLLAMA_URL`	`http://localhost:11434`	API-ендпоинт Ollama
`LOG_LEVEL`	`INFO`	Уровень детализации логирования
`ZED_WINDOWS_QUIRKS.md`	(см. файл)	Инструкции для Windows

🔧 Устранение неполадок

MCP-сервер не отвечает

Симптомы: таймаут инструментов, нет ответа.

Что проверить:

File → Quit → откройте проект заново
Запустите python install.py для перенастройки
Проверьте логи: %LOCALAPPDATA%\Zed\extensions\mscodebase-intelligence\.codebase_indices\logs\

Индекс пуст (0 чанков)

Запустите в панели агента:

intel_trigger_reindex()

Затем проверьте: get_index_status()

Проблемы с подключением LM Studio

# Проверьте, отвечает ли сервер:
python -c "import urllib.request; print(urllib.request.urlopen('http://localhost:1234/v1/health').read())"

Ожидается: {"status":"ok"}.

📁 Структура проекта

mscodebase-intelligence/
├── src/
│   ├── main.py                   # Точка входа MCP-сервера (~220 строк)
│   ├── lsp_main.py               # LSP-сервер (на DI, для индексации при didSave)
│   ├── mcp/
│   │   ├── server.py             # DI-маршрутизация — только импорты + регистрация
│   │   └── tools/                # 10 файлов, 33 инструмента на классах
│   │       ├── search_tools.py   # search_code, get_symbol_info, impact_analysis
│   │       ├── indexing_tools.py # notify_change, index_project_dir, index_health
│   │       ├── git_tools.py      # get_branch_info, get_commit_history
│   │       ├── system_tools.py   # get_index_status, watcher_status, read_live_file
│   │       ├── analysis_tools.py # structural_search, get_repo_map, scan_changes
│   │       ├── graph_tools.py    # cross_repo_search, graph_query, get_related_files
│   │       ├── investigation_tools.py  # get_bug_correlation, get_hotspots
│   │       └── lifecycle_tools.py      # submit_background_task, verify_action
│   ├── core/
│   │   ├── di_container.py       # ★ DI-контейнер (15 сервисов, ServiceCollection)
│   │   ├── error_handler.py      # ★ error_boundary + ToolError
│   │   ├── rate_limiter.py       # ★ SlidingWindowRateLimiter + DebounceBatch + CircuitBreaker
│   │   ├── indexer.py            # Векторное хранилище LanceDB
│   │   ├── searcher.py           # Гибридный поиск (BM25 + Dense + RRF)
│   │   ├── symbol_index.py       # Граф вызовов (BFS, анализ влияния)
│   │   ├── intelligence_layer.py # Инструменты intel_* (14 высокоуровневых)
│   │   ├── llama_runner.py       # ★ Менеджер жизненного цикла llama-server (reranker)
│   ├── remote_embedder.py    # ONNX/OpenVINO E5-base (in-process) + LM Studio / Ollama fallback
│   │   ├── reranker.py           # Мульти-провайдерный реранкер (HTTP к провайдерам)
│   │   ├── parser.py             # Tree-sitter AST
│   │   ├── health_report.py      # Движок самодиагностики
│   │   └── ...
│   └── utils/
│       ├── paths.py              # SafePathManager, to_win_long_path
│       └── zed_config.py         # Автонастройка Zed
├── docs/
│   ├── en/               # Документация на английском
│   ├── ru/               # Документация на русском
│   └── zh/               # Документация на китайском
├── tests/                        # 494 теста (pytest)
├── .agents/skills/               # Навыки для AI-агента
├── install.py                    # Установщик
└── README.md

🛠️ Разработка

См. CONTRIBUTING.md для:

Как добавлять новые MCP-инструменты
Структура тестов и CI-пайплайн
Соглашения по сообщениям коммитов

Быстрый старт для разработчиков

# Настройка
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

# Запуск MCP-сервера напрямую (тест)
python -m src.main

# Запуск тестов
pytest tests/ -m "not integration and not benchmark"

📄 Лицензия

Лицензия MIT — подробнее в LICENSE.

🙏 Благодарности

Zed IDE — редактор кода
LM Studio — локальный инференс LLM
LanceDB — векторная база данных
Model Context Protocol — стандарт MCP

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

MSCodebase Intelligence

🎯 Позиционирование

Что вы получаете

LSP: только для rename (гибридный режим)

Платформы

Языки

✨ Возможности

🚀 Быстрый старт

Провайдеры

📚 Карта документации

Основной поиск

Управление индексом

Система и диагностика

Аналитика

Git и история

Жизненный цикл и верификация

Write Tools (7)

Интеллектуальный слой (intel_*) — 14 высокоуровневых инструментов

Диагностические инструменты (3)

🏗️ Архитектура

Чистая архитектура с DI-контейнером

⚡ Производительность

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

🔧 Устранение неполадок

MCP-сервер не отвечает

Индекс пуст (0 чанков)

Проблемы с подключением LM Studio

📁 Структура проекта

🛠️ Разработка

Быстрый старт для разработчиков

📄 Лицензия

🙏 Благодарности

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

MSCodebase Intelligence

🎯 Позиционирование

Что вы получаете

LSP: только для rename (гибридный режим)

Платформы

Языки

✨ Возможности

🚀 Быстрый старт

Провайдеры

📚 Карта документации

Основной поиск

Управление индексом

Система и диагностика

Аналитика

Git и история

Жизненный цикл и верификация

Write Tools (7)

Интеллектуальный слой (intel_*) — 14 высокоуровневых инструментов

Диагностические инструменты (3)

🏗️ Архитектура

Чистая архитектура с DI-контейнером

⚡ Производительность

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

🔧 Устранение неполадок

MCP-сервер не отвечает

Индекс пуст (0 чанков)

Проблемы с подключением LM Studio

📁 Структура проекта

🛠️ Разработка

Быстрый старт для разработчиков

📄 Лицензия

🙏 Благодарности