Vesalius MCP
MCP-сервер строит карту кода на Mac: Claude Code получает ответы о вызовах и зависимостях со ссылками на файлы и строки.
- 82 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер читает исходники репозитория и хранит индекс на вашем Mac, а `setup` добавляет разрешение для инструментов в `~/.claude/settings.json`.
Установка
- Работает в
Ручная установка
brew install haplollc/tap/vesaliusПервая команда установки из README. Затем `vesalius setup` регистрирует сервер в Claude Code и Codex.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает исходники репозитория и хранит индекс на вашем Mac, а `setup` добавляет разрешение для инструментов в `~/.claude/settings.json`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Vesalius индексирует репозиторий целиком на вашем Mac и запоминает связи: какой файл кого использует, кто что вызывает, где живет функция. Claude Code обращается к карте через MCP-сервер `vesalius mcp` с пятью инструментами только для чтения и получает ответ с ссылками на файлы и строки, обычно за один вызов вместо цепочки поисков. Команда `vesalius setup` регистрирует сервер в Claude Code для всех проектов, добавляет `mcp__vesalius__*` в `permissions.allow` файла `~/.claude/settings.json` и индексирует текущий репозиторий. Если установлен `codex`, регистрация идет и там. Те же данные доступны человеку в приложении для Mac и расширении VS Code. Код остается на машине. Команда `vesalius setup --undo` отменяет все изменения.
Для кого. Разработчикам на Mac с Apple silicon, которые работают с Claude Code на больших репозиториях и хотят тратить меньше токенов на поиск.
Подходит, если
- Нужно узнать, кто вызывает `SessionStore.save` и что менять при переименовании.
- Новый разработчик ищет, где в проекте обрабатываются встроенные покупки.
- Перед рефакторингом проверяют, есть ли циклические импорты в `src/`.
- Команда делит одну регистрацию сервера через `.mcp.json` в репозитории.
Не подходит, если
- Нужен Intel Mac, Linux или Windows: нужен Mac с Apple silicon и macOS 15 или новее.
- Агент должен видеть живое состояние отладчика или выполнять код в IDE: карта строится по исходникам.
- Требуется язык, которого нет среди разбираемых: перечень языков стоит проверить заранее.
Пример запроса к агенту
Кто использует Theme в этом проекте и что придется менять, чтобы его переименовать? Ответь через Vesalius и покажи файлы со строками.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
VESALIUS_MCP_PROFILE- Профиль инструментов; значение `lean` подгружает инструменты по запросу.
Ограничения
Нужны Mac с Apple silicon и macOS 15 или новее и Claude Code либо другой клиент MCP. Установка командой `brew install haplollc/tap/vesalius` затрагивает `~/.claude/settings.json`: добавляется разрешение для инструментов только для чтения, и его можно пропустить флагом `--no-permissions`. Сборка из исходников требует Xcode 26 и занимает несколько минут из-за SwiftSyntax. Замеры в README сделаны авторами на 20 вопросах и показывают экономию токенов примерно вдвое: проверьте результат на своем репозитории.
Как отключить. Выполните `vesalius setup --undo`: он отменит регистрацию и разрешение. Затем удалите программу командой `brew uninstall vesalius` и при желании приложение для Mac.
Частые вопросы
Как поставить Vesalius?
Выполните `brew install haplollc/tap/vesalius`, затем `vesalius setup`. Сборка из исходников: `scripts/install-cli.sh` из клона репозитория.
Что меняет setup?
Он регистрирует `vesalius mcp` в Claude Code и Codex, добавляет `mcp__vesalius__*` в `permissions.allow` и индексирует репозиторий. В репозиторий, CLAUDE.md и хуки он не пишет.
Как зарегистрировать сервер вручную?
Выполните `claude mcp add --scope user vesalius -- vesalius mcp`. Для командной работы замените область на `project`, чтобы запись попала в `.mcp.json`.
Можно ли отключить автоматическое разрешение?
Да, запустите `vesalius setup --no-permissions`, а предварительный план покажет флаг `--dry-run`.
Как проверить подключение?
Команда `vesalius doctor` проверяет связь в любое время, а `vesalius stats` показывает, что спрашивал Claude.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыРасширение VS Code поднимает локальный MCP-сервер: агент ищет символы, правит файлы и запускает команды в терминале редактора
MCP-сервер, который дает агенту поиск по большому руководству Claude Code, официальной документации, релизам и готовым шаблонам
MCP-мост к VS Code отдает агенту диагностику языкового сервера и ссылки на символы вместо долгих tsc и eslint.
MCP-сервер семантического поиска по кодовой базе: индексирует проект в векторной базе и отдает агенту только нужные фрагменты
Постоянная память для Claude Code на вашей базе: захват решений и контекста плюс граф кода, все подмешивается в каждый запрос
Codex MCP Tool (cexll)
Codex MCP Tool
MCP-сервер передает задачи Codex CLI из Claude Code и Cursor: разбор кода по ссылкам @, песочница, правки патчем, идеи
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Vesalius (эта карточка) | нет | не нужна | 82 | |
| Serena | нет | не нужна | 31 335 | MCP-сервер, дающий агенту поиск символов и правку через LSP или JetBrains; Vesalius строит локальный индекс связей на Mac и отдает ответы только для чтения |
| CodeGraph | нет | не нужна | 77 481 | локальный граф кода для агентов с MCP; Vesalius работает на Mac и дополнен приложением и расширением VS Code |
Коротко о README
README подробно описывает быстрый старт, изменения при настройке, сборку из исходников, регистрацию вручную для Claude Code, Codex и Cursor, профили инструментов и результаты замеров.