CodeXray: локальный поиск кода MCP, который обогащает ИИ-ассистентов
CodeXray от Iohub — это поисковая система кода и движок знаний, осведомленный о репозиториях, который предоставляет AI-ассистентам глубокий контекст локального репозитория. Инструмент открывает артефакты репозитория для моделей через сервер Model Context Protocol и выполняет поиск кода, основанный на извлечении, структурный анализ и инкрементальную индексацию. Ключевые функции включают семантическое и точное извлечение, а также многомерную графику кода для выявления релевантных фрагментов. Он нацелен на программистов, которым нужен точный контекст, специфичный для репозитория, для AI-поддерживаемой разработки кода.
Для каких задач вы можете его использовать?
Инструмент поддерживает поиск, навигацию и анализ больших кодовых баз, комбинируя семантический векторный поиск с полным текстовым поиском BM25, позволяя запросам соответствовать намерению и точным токенам. Он предоставляет фрагменты кода, места вызова и ссылки на коммиты, на которые AI-ассистенты могут ссылаться во время завершения кода, объяснения или автоматизированных задач проверки. Этот двухканальный поиск помогает выявить как семантически связанные примеры, так и точные совпадения символов для отладки или обнаружения функций.
Насколько надежны результаты, ориентированные на код?
Надежность обеспечивается многомерной моделью знаний и структурным парсингом, а не сырыми языковыми предсказаниями. Реализация строит 4D Knowledge Graph, который связывает структурные и исторические сигналы, включая:
- графы вызовов для путей вызова
- векторы кода для семантического сходства
- векторы коммитов, связывающие изменения
- векторы знаний для извлеченных фактов
Парсинг Tree-sitter AST предоставляет структуру на уровне узлов, что обеспечивает доказательства, которые уменьшают риск галлюцинаций в ответах ассистента.
Какие входные данные и окружение он требует?
Инструмент индексирует локальные репозитории с помощью индексатора с инкрементальным обновлением в реальном времени, который отслеживает изменения файлов и автоматически обновляет артефакты. Он поддерживает несколько основных языков через парсеры Tree-sitter. Установка осуществляется с помощью однострочного установщика в оболочке, который автоматически определяет ОС хоста и регистрирует сервер MCP. Он работает на Linux, macOS и Windows (нативно или через WSL), что делает его пригодным для использования на общих машинах разработчиков и CI-хостах.
Подходит ли он для существующих рабочих процессов разработки с поддержкой ИИ?
Интеграция зависит от совместимости с протоколом Model Context Protocol: нативный сервер MCP нацелен на клиентов, совместимых с MCP, таких как Claude Code и Codex CLI, поэтому он подключается к AI-ассистентам, которые говорят на этом протоколе. Разработчик создал архитектуру с приоритетом локального хранения, чтобы код и встраивания оставались на хосте, и система использует внешние API встраивания только при явной настройке, в противном случае возвращаясь к графовому поиску. Этот дизайн поддерживает тесную связь с рабочими процессами ассистента без отправки содержимого репозитория за пределы хоста по умолчанию.
Инструмент практичен для инженеров, которым требуется контекст ИИ, осведомленный о репозитории
Инструмент является практичным вариантом для разработчиков, которые хотят, чтобы ИИ-ассистенты ссылались на реальную историю проекта и структуру, и он существенно уменьшает неподдерживаемые утверждения, предоставляя доказательства из репозитория. Ожидайте некоторую настройку для клиентов на основе MCP и продолжайте проверять сгенерированные предложения на корректность перед слиянием чувствительных изменений. На практике он дополняет человеческий обзор, а не заменяет его для редактирования кода с высокими ставками.