code-context-mcp
vlm-code-context-mcp
Постоянная память для ИИ-агентов по программированию.
Ваши агенты забывают всё между сессиями. Это решает проблему.
npm install vlm-code-context-mcp
npx code-context-mcp setup .
claude mcp add code-context npx -y vlm-code-context-mcp ./context.dbТри команды. Ноль API-ключей. Один файл context.db.
Бенчмарк
Протестировано на 10 реальных задачах разработки (поиск, отладка, рефакторинг, реализация), затем подтверждено 200 рандомизированными испытаниями и критерием Уилкоксона.
MCP | Обычный | Сэкономлено | |
Токены | 4,806 | 8,726 | 44.9% |
Вызовы инструментов | 49 | 68 | 27.9% |
Стохастический винрейт | — | — | 90.5% (p < 0.001) |
Инструменты MCP возвращают структурированные сводки (экспорт, зависимости, роль файла) вместо необработанного содержимого файлов. Агенты читают меньше, знают больше.
# Deterministic — 10 tasks, 6 categories
npm test -- test/benchmark.test.ts
# Stochastic — 200 randomized trials, Wilcoxon test, bootstrap CI
npm test -- test/benchmark-stochastic.test.tsПолная методология в BENCHMARK-GUIDE.md.
Related MCP server: code-tree-mcp
Быстрый старт
1 · Установка
npm install vlm-code-context-mcp2 · Инициализация
npx code-context-mcp setup .Создает context.db, индексирует вашу кодовую базу, инициализирует команду из 7 агентов и записывает .mcp.json.
3 · Перезапустите ваш ИИ-клиент
Перезапустите Claude Code (или любой другой MCP-клиент). Проверьте с помощью get_project_status.
4 · Запустите панель управления
npx code-context-dashboard ./context.dbОткрывается по адресу http://localhost:3333 с обновлениями SSE в реальном времени. Чтобы также автоматически переиндексировать при сохранении файла:
npx code-context-dashboard ./context.db 3333 .5 · Запустите свой первый спринт
Введите в Claude Code:
/kickoffОркестратор проведет вас через этапы: видение → обнаружение → веха → эпики → тикеты → спринт → реализация → ретроспектива — по одному вопросу за раз. Умное возобновление позволяет остановиться и продолжить позже.
Панель управления
7 страниц. Обновления SSE в реальном времени. Никакого опроса.
Страница | Что показывает |
Панель | Канбан-доска, пошаговый индикатор фаз, диаграмма сгорания, скорость, чек-лист спринта |
Планирование | Трекер вех, прогресс эпиков, конвейер обнаружения |
Код | Дерево файлов, граф зависимостей, карта экспорта/импорта, история изменений |
Команда | Карточки агентов, значки моделей, тренды настроения, шкалы нагрузки |
Ретро | Инсайты в сетке Bento, паттерны между спринтами, повторяющиеся темы |
Бенчмарк | Сравнение MCP и обычного режима с анимированными метриками |
Скорость | Тренды от спринта к спринту, запланировано против выполнено |
Каждое изменение базы данных вызывает мгновенное обновление через мониторинг SQLite WAL.
Слэш-команды
Введите их прямо в Claude Code.
Команда | Что делает |
| Полный жизненный цикл — от видения до ретроспективы. Начните отсюда. |
| Цикл только спринта — планирование → реализация → QA → ретроспектива → архив |
| Перемещение тикетов по их жизненному циклу с полным контекстом |
| Создание, обновление, закрытие вех с проверкой эпиков |
| Ретроспективы на основе данных с анализом сгорания и скорости |
| Связать UI панели управления с вашей сессией Claude |
Как это работает
Каждая команда следует одной и той же схеме: загрузить контекст из базы данных перед выполнением чего-либо.
search_files("auth middleware") → find the right file
get_file_context("src/auth.ts") → understand role, exports, dependents
Read("src/auth.ts") → only now read the actual codeНи один агент не держит весь проект в своем контекстном окне. Они запрашивают то, что им нужно, из общего «мозга» SQLite и записывают результаты обратно.
┌─────────────────────────────────────────────────────┐
│ Claude Code / MCP Client │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ /kickoff │ │ /sprint │ │ /ticket │ ... │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ └──────────────┼─────────────┘ │
│ ▼ │
│ 76 MCP Tools │
│ (32 read + 44 write) │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ context.db (SQLite) │ │
│ │ 30 tables · WAL mode · <5ms reads │ │
│ └──────────────────┬──────────────────┘ │
│ │ WAL watcher │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ React Dashboard (Vite) │ │
│ │ 62 components · SSE live updates │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘Команда агентов
9 настраиваемых агентов, каждый со своей ролью, моделью и показателем настроения.
Роль | Фокус |
Владелец продукта | Видение, приоритеты, согласование со стейкхолдерами |
Тимлид | Координация, ревью кода, качество |
Архитектор | Системный дизайн, технологические решения, структурная целостность |
Бэкенд-разработчик | API, база данных, серверная логика |
Фронтенд-разработчик | Компоненты панели управления, UI/UX |
Разработчик | Full-stack функции (фронтенд и бэкенд) |
QA-инженер | Тестирование, верификация, ворота качества |
Инженер по безопасности | Анализ уязвимостей, моделирование угроз, лучшие практики безопасности |
DevOps | CI/CD, сборки, развертывание |
Добавляйте, удаляйте или меняйте модели через инструменты MCP или одним кликом в панели управления.
Процесс спринта
4 фазы с принудительной проверкой на контрольных точках:
planning → implementation → done → restФаза | Длительность | Контрольная точка |
Планирование | 1 день | Тикеты назначены, скорость подтверждена |
Реализация | 3 дня | Все тикеты DONE или NOT_DONE, блокировщики устранены |
Готово | 0.5 дня | Результаты ретроспективы записаны, QA подтвержден |
Отдых | 0.5 дня | Автоматически после ретроспективы |
Фазы, длительность и контрольные точки полностью настраиваются через update_sprint_config.
Технологический стек
Слой | Технология |
Среда выполнения | Node.js 24 LTS |
База данных | SQLite через better-sqlite3, режим WAL |
Протокол MCP | @anthropic-ai/sdk |
Панель управления | React 19 + Vite + Zustand + Framer Motion |
Стили | CSS-переменные + Tailwind, темная тема |
Обновления в реальном времени | SSE через наблюдатель файла WAL |
Тестирование | Vitest |
Сборка | TypeScript в строгом режиме |
Цифры движка
Компонент | Количество |
Инструменты MCP | 76 (32 чтения + 44 записи) |
Таблицы базы данных | 30 (25 scrum + 5 code) |
React-компоненты | 62 |
Роли агентов | 9 (настраиваемые) |
Фазы спринта | 4 с контрольными точками |
Слэш-команды | 6 |
Ручная настройка MCP-сервера
Если автоматическая настройка .mcp.json не работает:
# Add to current project
claude mcp add code-context npx -y vlm-code-context-mcp ./context.db
# Add globally
claude mcp add --scope user code-context node /path/to/node_modules/vlm-code-context-mcp/dist/server/index.js ./context.db
# Remove
claude mcp remove code-contextРазработка
# MCP server
npm run dev
# Dashboard (Vite dev server with HMR)
npm run dashboard:devЛицензия
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Coding agents in multi-service codebases routinely rebuild existing helpers, trust stale type definitions, and modify API contracts without knowing who consumes them. Carrick solves this by indexing your entire TypeScript ecosystem across service and repository boundaries. By integrating deeply with the TypeScript compiler, Carrick traces every route, type, and cross-service call while recording function behaviour so agents search by intent rather than name. Delivered via MCP for AI agents and LSP for IDEs, Carrick ensures models see existing endpoints and utilities before generating new code. The scanner is source-available and runs from your CLI or CI pipeline.
Stateless TS/JS compiler facts for agents: references, imports, impact. No repo index or OAuth.
Repository knowledge graph MCP server for codebase understanding and debugging.
Hosted code graph over MCP: exact callers, dependencies, and cross-repo blast radius for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides code intelligence by indexing source code into SQLite and offering MCP tools for symbol search, flow tracing, and context retrieval to assist with code navigation and understanding.-
- FlicenseBqualityDmaintenanceAn MCP server that indexes source code into a local database and provides tools for querying code symbols, dependencies, and tree structure for JavaScript/TypeScript, Java, and Python.7-
- AlicenseAqualityCmaintenanceIndexes a mono-repo into a knowledge graph and provides MCP tools to query code structure—packages, components, routes, HTTP calls—without file reads or grep round-trips.722 npmMIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that indexes a local Python codebase into a SQLite graph for hybrid code search, file context, lazy explanations, dependency traces, and version-aware symbol history.MIT