Vexor

Vexor — MCP-сервер сообщества (автор — scarletkc). Семантический поиск по файлам и коду. Ставится через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
scarletkc
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
linux, macos, windows
Языки
python

Уровень риска: medium

Индексирует и возвращает содержимое файлов; при облачных эмбеддингах фрагменты уходят во внешний сервис. Ключ в VEXOR_API_KEY.

Настройка клиентов

codex
{
    "code": "codex mcp add vexor -- vexor mcp    # Codex",
    "lang": "bash",
    "notes": "Команда из README",
    "verified": "docs"
}

Что умеет

Vexor — семантический поиск по файлам. Он помогает, когда вы помните, что делает файл, но забыли его имя или расположение: не нужно подбирать шаблоны grep или обходить папки вручную. Инструмент рассчитан и на людей, и на ИИ-ассистентов в автономной работе.

Во встроенном MCP-сервере (stdio) два инструмента:

  • vexor_search — семантический поиск файлов; возвращает найденный исходный текст, поэтому агенту редко нужно отдельно читать файл;
  • vexor_index — явное построение индекса заранее.

При первом поиске Vexor сам индексирует папку. Режимы индексации: по имени, началу файла, краткому описанию, полному тексту, коду или структуре. Ненужные файлы исключаются через .vexorignore. Дополнительное ранжирование (--rerank hybrid) сочетает точное совпадение ключевых слов с семантическим поиском. Можно работать и полностью офлайн с локальными моделями эмбеддингов.

Кроме MCP-сервера, есть утилита командной строки, API на Python и навык для агентов. README советует выбрать для одного агента что-то одно — навык или MCP-сервер.

Кому подойдёт

  • Разработчикам в больших репозиториях: поиск «где у нас загрузка конфига» без знания имён файлов.
  • Тем, кто подключает поиск к Cursor, Windsurf или Zed: MCP-сервер работает в любом MCP-клиенте.
  • Командам с требованиями к приватности: локальные модели эмбеддингов без отправки кода в облако.

Похожие серверы — в категории разработка.

Установка

Скачайте готовый исполняемый файл со страницы релизов (Python не нужен) или установите пакет:

pip install vexor

Подходят также pipx и uv. Мастер настройки vexor init спрашивает сервис эмбеддингов и ключ API. По умолчанию используется OpenAI, доступны также Gemini, Voyage AI, свой сервер и локальные модели. Ключ задаётся переменной VEXOR_API_KEY. Глобальные настройки хранятся в ~/.vexor/config.json, проектные — в .vexor/config.json. Для MCP-клиентов несекретные параметры можно передать в VEXOR_CONFIG_JSON, и тогда vexor init не нужен.

Подключение к клиентам

Команды и конфиг приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add vexor -- vexor mcp   # Claude Code

В общем конфиге замените значение VEXOR_API_KEY своим ключом или уберите блок env, если настройка уже сделана через vexor init.

Проверка

Попросите агента найти через Vexor файл, отвечающий за загрузку настроек. В ответе должен быть список файлов с оценкой похожести и фрагментами исходного текста.

Примеры задач

Найди в проекте код, который повторяет HTTP-запросы при ошибках, и покажи пять лучших совпадений.
Построй индекс папки ~/projects/demo в режиме code, чтобы поиск работал быстрее.

Риски

  • Чтение файлов. Сервер индексирует и возвращает содержимое файлов из указанных папок. Исключайте секреты и закрытые данные через .vexorignore.
  • Отправка в облако. При облачном сервисе эмбеддингов фрагменты файлов уходят на его сервера. Для приватного кода используйте локальные модели.
  • Ключ API. Передаётся через VEXOR_API_KEY; не храните его в общих файлах и репозиториях.

Частые вопросы

Нужен ли ключ API?

Только для облачных сервисов эмбеддингов. С локальными моделями Vexor работает офлайн.

Чем MCP-сервер отличается от навыка?

Навык учит агентов с доступом к командной строке (Claude Code, Codex) пользоваться всей утилитой, а MCP-сервер даёт поиск как встроенный инструмент в любом MCP-клиенте.

Нужно ли строить индекс вручную?

Нет, индекс создаётся при первом поиске. Явная индексация полезна для прогрева в CI или при выключенной автоиндексации.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники