Mellos Mapping MCP
MCP-сервер и терминальная панель рисуют слоистую карту зависимостей: проект-призрак, текущий шаг и проверенные узлы.
- 116 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Пишет файлы карты в папку проекта, а на Windows хук добавляет команду `mmap` в пользовательский PATH.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mellos-mappingОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Пишет файлы карты в папку проекта, а на Windows хук добавляет команду `mmap` в пользовательский PATH.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Mellos Mapping показывает рядом с чатом живую карту системы, которую агент строит снизу вверх. Нижние слои занимают базовые примитивы, ребра зависимостей смотрят только вниз. Пунктирные призрачные узлы обозначают спроектированное, индикатор крутится на том, что собирается сейчас, а зеленым горит построенное и проверенное. Восемь инструментов `mmap_*`, среди них `mmap_declare`, `mmap_read`, `mmap_open` и `mmap_remove`, пишут карту в `.mellos/map.json` проекта. Узел зеленеет только с доказательством, например с прошедшим тестом, а треснувший фундамент краснеет. Сервер отклоняет лишь структурную порчу: ребро вверх или дубль ранга.
Для кого. Разработчики, которые поручают Claude Code или Codex сборку системы по слоям и хотят видеть, на чем стоит каждый узел и что уже проверено.
Подходит, если
- Агент проектирует архитектуру, и призрачная схема появляется до первой строки кода.
- Нужно видеть, над чем агент работает сейчас и на каких слоях.
- После правок проверяют, не треснул ли фундамент: узел краснеет.
- Работу возобновляют в новой беседе через `mmap_read`.
Не подходит, если
- Нужен список задач сверху вниз: карта растет снизу и показывает зависимости, а не расписание.
- Клиент не поддерживает MCP: без него инструментов `mmap_*` нет.
- Нужна рабочая дисциплина в Cursor или Windsurf: скилл-слой рассчитан на Claude Code и Codex.
Пример запроса к агенту
Заранее объяви призрачную карту слоев игрового движка, открой панель и подсвечивай узлы по мере прохождения тестов.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
MELLOS_MAPPING_CWD- Папка проекта для карты, если клиент запускает сервер в другом месте
MELLOS_MAPPING_NO_STAR- Значение 1 отключает однократное напоминание про звезду на GitHub
MELLOS_MAPPING_TMUX_TARGET- Сессия или панель tmux для открытия карты, например work:2.1
Ограничения
Нужен Node.js 18.17 и новее в линейке 18.x либо 20.3 и выше. Скилл с рабочей дисциплиной действует только в Claude Code и Codex, остальные клиенты получают восемь инструментов и панель. На Linux и macOS панель открывается через tmux. Если клиент запускает сервер не в папке проекта, задайте `MELLOS_MAPPING_CWD`. В варианте из npm панель один раз показывает напоминание поставить звезду на GitHub, отключить его можно через `MELLOS_MAPPING_NO_STAR=1`.
Как отключить. Удалите плагин через менеджер `/plugin` либо уберите запись MCP из конфига клиента. Папку `.mellos/` в проекте очистите вручную.
Частые вопросы
Как установить в Claude Code?
Выполните `/plugin marketplace add GuangminJu/mellos-mapping`, затем `/plugin install mellos-mapping@mellos-mapping`. После установки откройте новую беседу.
Как подключить в Cursor или Windsurf?
Добавьте stdio-сервер с командой `npx -y mellos-mapping`. Панель открывают командой `npx -y -p mellos-mapping mellos-mapping-watch` из папки проекта.
Когда узел становится зеленым?
Только с доказательством проверки, например с прошедшим тестом. Если поздняя работа ломает фундамент, узел краснеет.
Где хранится карта?
В `.mellos/map.json` рабочей папки сессии. Другую папку задают переменной `MELLOS_MAPPING_CWD`.
Какие платформы поддерживаются?
Windows 10 и новее, macOS 13 и новее, Linux с glibc 2.28 и новее, на x64 или arm64. Нативные привязки идут в релизе, компиляция не нужна.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСкилл строит карту репозитория по смысловым блокам, разбирает на ней код по шагам и подсвечивает сломанные места
DevLens строит граф репозитория один раз, и агент по MCP получает ранжированные файлы, вызовы и радиус изменений
Локальный MCP-сервер с графом вызовов и поиском символов: агент видит структуру кода и последствия правки заранее.
Считает, какие файлы импортируют друг друга и что заденет правка, и отдает это агенту через хуки, MCP и команду codemap
Конвейер «сначала план, потом код» для Claude Code и Codex: спецификация, малые контракты, проверка этапов и ревью
codesight за один запуск собирает карту проекта: маршруты, модели БД, зависимости, env-переменные. Отдает ее агенту файлами или через MCP-сервер
Коротко о README
Установка зависит от клиента: плагин для Claude Code и omp, установщик для Codex, расширение для pi, stdio для остальных.