adrianczuczka/mason

adrianczuczka/mason

от adrianczuczka
Mason — MCP-сервер для AI-ассистентов, который строит концептуальную карту кодовой базы. Вместо повторного чтения файлов ассистент загружает карту, экономя до 67% токенов на архитектурных вопросах....

Mason – the context builder for LLMs 👷

npm version CI npm downloads license issues

A persistent concept map for your AI coding assistant — so it stops re-exploring your codebase every session.

Up to 67% fewer tokens on architecture questions · same answer quality · MCP-only

claude mcp add mason --scope user -- npx -p mason-context mason-mcp

Restart Claude Code, then ask: "use mason to set up this project." The assistant calls mason_init, walks you through a quick Q&A to build the concept map, and you're done.

Next session, your assistant loads the map instead of grepping 8 files to figure out what your app does.

0.4.0 note: Mason is MCP-only as of v0.4.0. The previous mason <command> CLI has been removed — everything runs through MCP tools, driven by your assistant. See 0.4.0 migration below if you used the old CLI.


The pain

Every new conversation about your code, your assistant starts from zero. It greps for auth, reads three files, greps for user, reads three more, pieces together the architecture, then finally answers. Tomorrow you ask a different question — same dance. The understanding it built yesterday is gone.

analyze_project

Выполняет анализ истории git в кодовой базе. Возвращает паттерны соглашений о коммитах, устаревшие директории и часто изменяемые файлы. Это совокупная статистика по сотням коммитов, которую было бы трудоёмко вычислить вручную.

Выполняет анализ истории git в кодовой базе. Возвращает паттерны соглашений о коммитах, устаревшие директории и часто изменяемые файлы. Это совокупная статистика по сотням коммитов, которую было бы трудоёмко вычислить вручную.

Параметры

  • dirstringобязательный

    Absolute path to the project root directory

full_analysis

Выполняет полный анализ проекта за один вызов. Возвращает статистику истории git, структуру проекта с количеством файлов, подобранные образцы кода (примерно по 60 строк каждый) и сопоставление тестовых и исходных файлов. Это рекомендуемая отправная точка — сначала вызывайте этот инструмент, затем читайте конкретные файлы нативно для получения полного содержимого.

Выполняет полный анализ проекта за один вызов. Возвращает статистику истории git, структуру проекта с количеством файлов, подобранные образцы кода (примерно по 60 строк каждый) и сопоставление тестовых и исходных файлов. Это рекомендуемая отправная точка — сначала вызывайте этот инструмент, затем читайте конкретные файлы нативно для получения полного содержимого.

Параметры

  • dirstringобязательный

    Absolute path to the project root directory

get_code_samples

Получает превью (первые ~60 строк) репрезентативных файлов исходного кода из кодовой базы. Включает точки входа, конфигурационные файлы, горячие файлы (часто изменяемые), тестовые примеры и по одному файлу из каждой директории для охвата. Читает файлы нативно для полного содержимого.

Получает превью (первые ~60 строк) репрезентативных файлов исходного кода из кодовой базы. Включает точки входа, конфигурационные файлы, горячие файлы (часто изменяемые), тестовые примеры и по одному файлу из каждой директории для охвата. Читает файлы нативно для полного содержимого.

Параметры

  • dirstringобязательный

    Absolute path to the project root directory

  • countnumber

    Maximum number of files to sample (default: 15)

get_impact

Анализируйте влияние изменения конкретных файлов. Возвращает три сигнала: git co-change (файлы, которые исторически меняются вместе), references (файлы, которые упоминают цель по имени) и related tests. Используйте это перед тем как редактировать файл, чтобы понять, что ещё нужно обновить.

Анализируйте влияние изменения конкретных файлов. Возвращает три сигнала: git co-change (файлы, которые исторически меняются вместе), references (файлы, которые упоминают цель по имени) и related tests. Используйте это перед тем как редактировать файл, чтобы понять, что ещё нужно обновить.

Параметры

  • dirstringобязательный

    Absolute path to the project root directory

  • filesstring[]обязательный

    File paths or names to analyze (e.g., ['WeatherRepository.kt'] or ['src/services/auth.ts'])

get_snapshot

Получите концептуальную карту проекта: таблицу соответствия функций и потоков файлам, которые их реализуют. Используйте её, чтобы переходить прямо к нужным файлам, а не исследовать код. Пример: 'home screen' → [HomeScreen.kt, HomeViewModel.kt, HomeModule.kt]. Если карта устарела, запустите 'mason snapshot-update' для обновления.

Получите концептуальную карту проекта: таблицу соответствия функций и потоков файлам, которые их реализуют. Используйте её, чтобы переходить прямо к нужным файлам, а не исследовать код. Пример: 'home screen' → [HomeScreen.kt, HomeViewModel.kt, HomeModule.kt]. Если карта устарела, запустите 'mason snapshot-update' для обновления.

Параметры

  • dirstringобязательный

    Absolute path to the project root directory

save_snapshot

Сохраняет карту соответствия концепций файлам в виде постоянного снимка проекта. Отображает названия функций и потоки данных на файлы, которые их реализуют. Сохраняется между сеансами — будущие сессии могут вызвать get_snapshot, чтобы мгновенно найти нужные файлы. Не требуется API-ключ — вы — LLM, которая генерирует эту карту.

Сохраняет карту соответствия концепций файлам в виде постоянного снимка проекта. Отображает названия функций и потоки данных на файлы, которые их реализуют. Сохраняется между сеансами — будущие сессии могут вызвать get_snapshot, чтобы мгновенно найти нужные файлы. Не требуется API-ключ — вы — LLM, которая генерирует эту карту.

Параметры

  • dirstringобязательный

    Absolute path to the project root directory

  • featuresobjectобязательный

    Map of feature names to their implementing files

  • flowsobjectобязательный

    Map of flow names to ordered file chains

Другие проверенные MCP-сервера

GreptimeTeam/greptimedb-mcp-server

GreptimeTeam/greptimedb-mcp-server

официальный

GreptimeDB MCP-сервер для AI-ассистентов - выполняет SQL, TQL и RANGE-запросы к open-source базе наблюдаемости, объединяющей метрики, логи и трейсы. Встроенная безопасность: read-only, маскировка д...

Python28
ClickHouse/mcp-clickhouse

ClickHouse/mcp-clickhouse

официальный

MCP сервер для работы с ClickHouse: выполняет SQL-запросы, перечисляет базы и таблицы с пагинацией. Поддерживает chDB для быстрых встраиваемых запросов без ETL. Полезен разработчикам и аналитикам для интеграции ClickHouse в AI-инструменты через MCP.

Python826
ravitemer/mcphub.nvim

ravitemer/mcphub.nvim

MCP Hub — MCP клиент для Neovim, интегрирующий серверы MCP в редактор. Управляйте инструментами, ресурсами и промптами, используйте с чат-плагинами (Avante, CodeCompanion). Подходит разработчикам, автоматизирующим код через AI.

Lua1784
dagger/container-use

dagger/container-use

официальный

MCP сервер container-use даёт агентам (Claude Code, Cursor) работать параллельно в изолированных контейнерах - безопасно и без конфликтов. Полезен разработчикам: видит лог действий и даёт доступ к ...

Go3914
steipete/peekaboo

steipete/peekaboo

MCP сервер для macOS с захватом экрана, AI-анализом и автоматизацией GUI: клики, ввод, скроллинг, горячие клавиши. Требует разрешений на запись экрана и доступность. Полезен разработчикам и тестировщикам.

Swift4879
Gitlab MCP

Gitlab MCP

GitLab MCP сервер для AI-клиентов: управляйте проектами, merge request, issues, pipelines, wiki и релизами. Поддерживает PAT, OAuth, read-only режим и удаленную авторизацию. Работает с VS Code, Claude, Cursor и другими MCP инструментами.

TypeScript1819
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин