Skip to main content
Glama

vlm-code-context-mcp

Постоянная память для ИИ-агентов по программированию.

Ваши агенты забывают всё между сессиями. Это решает проблему.

License: MIT npm version npm downloads

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-mcp

2 · Инициализация

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.

Команда

Что делает

/kickoff

Полный жизненный цикл — от видения до ретроспективы. Начните отсюда.

/sprint

Цикл только спринта — планирование → реализация → QA → ретроспектива → архив

/ticket

Перемещение тикетов по их жизненному циклу с полным контекстом

/milestone

Создание, обновление, закрытие вех с проверкой эпиков

/retro

Ретроспективы на основе данных с анализом сгорания и скорости

/sprint-connect

Связать 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

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides 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.
    -
  • F
    license
    B
    quality
    D
    maintenance
    An 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
    -
  • A
    license
    A
    quality
    C
    maintenance
    Indexes 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.
    7
    22 npm
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    An 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