# sqry - Semantic Code Search

MCP-сервер с семантическим поиском по коду на основе AST: находит символы, связи и последствия правок в 37 языках.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 31
- Автор: verivus-oss
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/verivus-oss/sqry/tree/HEAD/sqry-mcp
- Обновлён: 2026-10-06
- HTML: https://affpapa.org/nevibecode/mcp/sqry-semantic-code-search

## Что делает

\`sqry-mcp` отдаёт инструменты sqry семантического поиска MCP-клиентам. В автономном режиме доступно 39 инструментов, в режиме с демоном — подмножество из 17, которое обслуживает `sqryd`. Точные схемы и описания лучше смотреть динамически: через `tools/list`, `sqry-mcp --list-tools` или ресурс `sqry://meta/manifest`.

Каталог покрывает поиск символов, навигацию, запросы связей, экспорт графа, анализ влияния, семантический диф, поиск дублей, циклов и неиспользуемого кода, статус воркспейса и распространение контекста. В запросах есть строковые предикаты и структурные JSON-фильтры: например, `semantic_search` принимает `query` вида `kind:function items:true` вместе с `filters` по языку и видимости. Для `list_symbols` вместо предиката используется параметр `items_only`.

Работает через Docker: в командах запуска фигурирует образ `ghcr.io/verivus-oss/sqry-mcp:v33.0.1`, а корень воркспейса задаётся переменной `SQRY_MCP_WORKSPACE_ROOT`. Режим с демоном требует, чтобы `sqryd` был запущен и загружен заранее, поэтому без этого шага флаг `--daemon` не сработает. Настройка пишется командой `sqry mcp setup --tool claude` (или `codex`, `gemini`), предпросмотр — с `--dry-run`. Для проектов с несколькими корнями воркспейс описывают файлом `.sqry-workspace` либо `.code-workspace` с полем `sqry.workspace`.

## Требования
- Нужно: Docker
- Переменные окружения: `SQRY_MCP_WORKSPACE_ROOT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env SQRY_MCP_WORKSPACE_ROOT=<SQRY_MCP_WORKSPACE_ROOT> --transport stdio sqry-mcp -- docker run -i --rm -e SQRY_MCP_WORKSPACE_ROOT ghcr.io/verivus-oss/sqry-mcp:v33.0.1
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add sqry-mcp --env SQRY_MCP_WORKSPACE_ROOT=<SQRY_MCP_WORKSPACE_ROOT> -- docker run -i --rm -e SQRY_MCP_WORKSPACE_ROOT ghcr.io/verivus-oss/sqry-mcp:v33.0.1
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sqry-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "SQRY_MCP_WORKSPACE_ROOT",
                "ghcr.io/verivus-oss/sqry-mcp:v33.0.1"
            ],
            "env": {
                "SQRY_MCP_WORKSPACE_ROOT": "<SQRY_MCP_WORKSPACE_ROOT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "sqry-mcp": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "SQRY_MCP_WORKSPACE_ROOT",
                "ghcr.io/verivus-oss/sqry-mcp:v33.0.1"
            ],
            "env": {
                "SQRY_MCP_WORKSPACE_ROOT": "<SQRY_MCP_WORKSPACE_ROOT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e SQRY_MCP_WORKSPACE_ROOT=<SQRY_MCP_WORKSPACE_ROOT> sqry-mcp docker run -i --rm -e SQRY_MCP_WORKSPACE_ROOT ghcr.io/verivus-oss/sqry-mcp:v33.0.1
```
Вместо <…> подставьте свои значения

## Когда брать
- найти определение функции и все места, где её вызывают
- оценить, что сломается после правки в общем модуле
- выгрузить граф связей между символами проекта
- отловить дубли и циклы в большой кодовой базе
- найти неиспользуемый код перед рефакторингом

## Примеры запросов агенту
- Найди через `semantic_search` все публичные функции на Rust в этом проекте
- Покажи через `list_symbols` только определения функций
- Прогони анализ влияния по изменённому модулю и скажи, что затронуто

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

## Другие версии с тем же именем
- [sqry - Semantic Code Search · verivus-oss](https://affpapa.org/nevibecode/mcp/verivus-oss-sqry-semantic-code-search.md) — ★ 31

Из того же набора: [verivus-oss/sqry](https://affpapa.org/nevibecode/by/verivus-oss/sqry.md) — 2 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md