Topos — MCP-сервер для Claude Code: анализ структуры кода
Topos оценивает сложность, связанность и рискованные потоки данных в репозитории. Подключите его, когда хотите дать агенту конкретную структурную проблему для проверки и исправления.
claude mcp add topos -- uvx topos-mcpЧто делает Topos
Topos анализирует устройство программы, находит проблемные места и предлагает агенту конкретную цель для улучшения. Он оценивает сложность, связанность, рискованные потоки данных и нагрузку на понимание кода. Анализ можно повторять после правок, чтобы проверить результат.
Сервер поддерживает Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed и Gemini CLI. Для Claude Code команда установки использует uvx topos-mcp. В терминале CLI автоматически определяет проекты на Python, Rust, JavaScript, TypeScript, C++ и Go; флаг --language сужает проверку. Topos оценивает структуру, а не поведение тестов, поэтому он не заменяет запуск тестового набора.
Какие задачи решает
- найти наиболее серьёзную структурную проблему в репозитории
- обнаружить чрезмерную сложность и связанность кода
- проверить рискованные потоки данных
- повторно оценить структуру после рефакторинга
Примеры запросов агенту
- Найди в этом репозитории главную структурную проблему и предложи одно точечное улучшение.
- Проверь сложность и связанность кода, затем покажи проблемные места.
- Повтори оценку после правок и сравни результат.
Как установить Topos
Командой платформы
claude mcp add topos -- uvx topos-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from topos-mcp <команда>
Командой платформы
codex mcp add topos -- uvx topos-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from topos-mcp <команда>
Файл настроек
{
"mcpServers": {
"topos": {
"command": "uvx",
"args": [
"topos-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from topos-mcp <команда>
Файл настроек
{
"servers": {
"topos": {
"type": "stdio",
"command": "uvx",
"args": [
"topos-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from topos-mcp <команда>
Командой платформы
gemini mcp add topos uvx topos-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from topos-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Topos
Как установить Topos в Claude Code?
Выполните claude mcp add topos -- uvx topos-mcp, затем перезапустите Claude Code.
Что делает Topos?
MCP-сервер оценивает структуру кода, находит проблемные участки и задаёт агенту конкретную цель для улучшения.
Какие языки распознаёт CLI Topos?
CLI автоматически определяет Python, Rust, JavaScript, TypeScript, C++ и Go. Флаг --language позволяет ограничить проверку одним выбранным языком.
