codesurface — MCP-сервер для Claude Code: что делает и как установить
Индексирует публичные классы, методы и поля в репозитории, отдавая модели точные сигнатуры и номера строк для точечного чтения кода.
claude mcp add codesurface -- uvx codesurfaceЧто делает codesurface
Сервер сканирует проект при старте и разбирает публичный интерфейс. Он работает с кодом на C#, Java, Go, Python, TypeScript и с C++ заголовками. Вместо чтения файлов целиком ассистент получает компактные описания. Это бережёт контекст.
Набор включает инструменты search, get_signature, get_class, get_stats и reindex. Инструмент reindex смотрит на время изменения файлов и обновляет индекс на лету при неточных запросах. Каждая запись возвращает диапазон строк. Поэтому агент запрашивает точный срез файла, а не сотни строк реализации.
Для работы нужен Python версии не ниже 3.10 и утилита uvx. Без флага --project с путём к каталогу с кодом сервер не найдёт файлы проекта.
Какие задачи решает
- найти сигнатуру метода без загрузки всего файла в контекст модели
- собрать список всех публичных членов конкретного класса
- определить точные номера строк объявления для адресного чтения исходников
- обновить индекс кодовой базы только по изменённым файлам
Примеры запросов агенту
- Найди сигнатуру функции TryMerge через codesurface
- Покажи все публичные члены класса BlastBoardModel
- Выведи статистику по проиндексированному коду проекта
Как установить codesurface
Командой платформы
claude mcp add codesurface -- uvx codesurfaceuvx запускает команду с именем пакета; если в README она другая — uvx --from codesurface <команда>
Командой платформы
codex mcp add codesurface -- uvx codesurfaceuvx запускает команду с именем пакета; если в README она другая — uvx --from codesurface <команда>
Файл настроек
{
"mcpServers": {
"codesurface": {
"command": "uvx",
"args": [
"codesurface"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from codesurface <команда>
Файл настроек
{
"servers": {
"codesurface": {
"type": "stdio",
"command": "uvx",
"args": [
"codesurface"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from codesurface <команда>
Командой платформы
gemini mcp add codesurface uvx codesurfaceuvx запускает команду с именем пакета; если в README она другая — uvx --from codesurface <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о codesurface
Как установить codesurface в Claude Code?
Выполните в терминале команду claude mcp add codesurface -- uvx codesurface. Для привязки к конкретному каталогу добавьте аргумент --project с путём к исходникам.
Зачем нужен codesurface?
Сервер индексирует публичный API кодовой базы и отдаёт модели сигнатуры с номерами строк. Это позволяет ассистенту читать только нужные фрагменты файлов и экономить токены контекста.
Какие языки программирования поддерживает codesurface?
Сервер разбирает файлы на Python, Java, Go, C#, TypeScript, JavaScript, а также заголовочные файлы C++. Тестовые каталоги и файлы тестов по умолчанию исключаются из выдачи.
