MCP-сервер, который подключает AI-агентов к Exa для веб-поиска, получения содержимого страниц и многоэтапного исследования.
MinishLab/semble
Библиотека для поиска кода, которая возвращает AI-агентам только нужные фрагменты и работает на CPU без API-ключей.
- Звёзды
- 6,367
- Форки
- 286
- Открытые issues
- 7
- Последний коммит
- 4 дня назад
Что это?
Semble — библиотека для поиска кода, предназначенная для coding-агентов, таких как Claude Code, Cursor и Codex. Она принимает запрос на естественном языке или фрагмент кода и возвращает подходящие фрагменты из репозитория, вместо того чтобы агент искал ключевые слова через grep и читал файлы целиком. Так на изучение кодовой базы уходит меньше токенов.
Библиотека разбивает файлы на фрагменты с учётом структуры кода с помощью tree-sitter и оценивает запрос двумя поисковыми механизмами: статическими эмбеддингами Model2Vec для семантического сходства и BM25 для поиска по идентификаторам и названиям API. Результаты объединяются с помощью Reciprocal Rank Fusion и повторно ранжируются с учётом таких сигналов, как повышение приоритета определений и штрафы для тестовых файлов. Индексы кэшируются и обновляются инкрементально при изменении файлов.
Semble можно использовать как MCP-сервер, CLI с интеграцией в AGENTS.md или через Python API. Библиотека принимает локальные пути и git URL, умеет искать сразу по нескольким репозиториям и поддерживает контент типов code, docs и config.
Ключевые возможности
- 01Возвращает ранжированные фрагменты кода для запросов на естественном языке и запросов с кодом.
- 02Работает на CPU без API-ключей, GPU и внешних сервисов.
- 03Предоставляет MCP-сервер с инструментами поиска и поиска связанного кода.
- 04Включает CLI и Python-библиотеку для скриптов и собственных инструментов.
- 05Ищет по нескольким локальным или удалённым git-репозиториям как по единому корпусу.
- 06Учитывает .gitignore и .sembleignore и инкрементально обновляет индексы.
Сценарии использования
- Помогать coding-агенту находить нужные функции перед редактированием большой кодовой базы.
- Искать endpoint или определение сразу в нескольких репозиториях микросервисов.
- Сокращать расход токенов в рабочих процессах агентов, которые иначе используют grep и читают файлы целиком.
- Автоматизировать поиск кода в CI или изолированных средах без сетевых API-вызовов.
Быстрый старт
- 1
Установите uv (см. руководство по установке uv)
- 2
Установите semble как инструмент uv
uv tool install semble - 3
Запустите интерактивный установщик, чтобы настроить интеграции с агентами
semble install
Что важно знать
- В README указано, что при первом использовании с Hugging Face загружается определённая модель эмбеддингов, поэтому один раз потребуется подключение к сети.
В подборках
Темы
Частые вопросы
- Что такое semble?
- Библиотека для поиска кода, которая возвращает AI-агентам только нужные фрагменты и работает на CPU без API-ключей. Semble — библиотека для поиска кода, предназначенная для coding-агентов, таких как Claude Code, Cursor и Codex. Она принимает запрос на естественном языке или фрагмент кода и возвращает подходящие фрагменты из репозитория, вместо того чтобы агент искал ключевые слова через grep и читал файлы целиком. Так на изучение кодовой базы уходит меньше токенов.
- semble можно использовать бесплатно? Какая у него лицензия?
- semble распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- semble всё ещё поддерживается?
- Активно поддерживается. Последний коммит в semble — 3 нояб. 2026 г..
- Для чего можно использовать semble?
- Помогать coding-агенту находить нужные функции перед редактированием большой кодовой базы. Искать endpoint или определение сразу в нескольких репозиториях микросервисов. Сокращать расход токенов в рабочих процессах агентов, которые иначе используют grep и читают файлы целиком. Автоматизировать поиск кода в CI или изолированных средах без сетевых API-вызовов.
- Как установить semble?
- Установите uv (см. руководство по установке uv) Установите semble как инструмент uv: uv tool install semble Запустите интерактивный установщик, чтобы настроить интеграции с агентами: semble install
- Где скачать semble?
- Исходный код и инструкции по установке — на GitHub: https://github.com/MinishLab/semble
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
CLI-инструмент для поиска по коду: учитывает его структуру и релевантность результатов, не требуя индексации.
CLI для семантического поиска по коду на основе AST и MCP-сервер, который индексирует кодовую базу, чтобы coding agents могли находить код по смыслу.
CLI для семантического поиска по коду с локальными эмбеддингами, анализом графа вызовов и MCP-сервером для AI-агентов — с приоритетом конфиденциальности.
Локальный MCP-сервер, который перенаправляет запросы из Cursor, VS Code, Windsurf или Claude Desktop в ChatGPT, Claude, Gemini, Perplexity, BYOK API или локальные модели Ollama.
Локальный CLI и инструмент для агентов: поиск по рабочей директории с помощью ripgrep, BM25 и векторного поиска.