# Komplyt Zero

Сервер долговременной памяти для агентов в виде графа знаний. Сохраняет архитектурные решения и контекст между сессиями разных клиентов.

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

## Что делает

Komplyt Zero связывает разные клиенты с единой базой знаний. Вместо обычного поиска по ключевым словам инструмент выстраивает граф из типизированных узлов. Агент фиксирует принятые решения, открытые проблемы и обоснования. Когда разработчик возвращается к задаче спустя время в другой IDE, система находит исходные аргументы по смыслу запроса.

Внутри работает семантический поиск с формулой затухания и переходом по связям графа. Знания, к которым долго не обращаются, опускаются в выдаче ниже, но не удаляются совсем. Для работы локального варианта через Docker Compose требуются база SurrealDB и локальная модель эмбеддингов Ollama.

Быстрый локальный запуск предназначен для одного человека и слушает только адрес `localhost`. Публиковать этот порт в сеть без внешнего прокси с авторизацией небезопасно: локальный режим работает без проверки токенов.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://kg.kompl.yt/mcp`
- Переменные окружения: `KG_AUTH_MODE`, `KG_DB_URL`, `KG_DB_USER`, `KG_DB_PASS`, `KG_JWT_SECRET`, `EMBEDDING_PROVIDER`, `EMBEDDING_BASE_URL`, `EMBEDDING_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http komplyt-zero https://kg.kompl.yt/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env KG_AUTH_MODE=<KG_AUTH_MODE> --env KG_DB_URL=<KG_DB_URL> --env KG_DB_USER=<KG_DB_USER> --env KG_DB_PASS=<KG_DB_PASS> --env KG_JWT_SECRET=<KG_JWT_SECRET> --transport stdio src -- npx -y @komplyzen/komplyt-zero
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add src --url https://kg.kompl.yt/mcp
```

2. **Командой платформы**
```bash
codex mcp add src --env KG_AUTH_MODE=<KG_AUTH_MODE> --env KG_DB_URL=<KG_DB_URL> --env KG_DB_USER=<KG_DB_USER> --env KG_DB_PASS=<KG_DB_PASS> --env KG_JWT_SECRET=<KG_JWT_SECRET> -- npx -y @komplyzen/komplyt-zero
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "src": {
            "url": "https://kg.kompl.yt/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "src": {
            "command": "npx",
            "args": [
                "-y",
                "@komplyzen/komplyt-zero"
            ],
            "env": {
                "KG_AUTH_MODE": "<KG_AUTH_MODE>",
                "KG_DB_URL": "<KG_DB_URL>",
                "KG_DB_USER": "<KG_DB_USER>",
                "KG_DB_PASS": "<KG_DB_PASS>",
                "KG_JWT_SECRET": "<KG_JWT_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "src": {
            "type": "http",
            "url": "https://kg.kompl.yt/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "src": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@komplyzen/komplyt-zero"
            ],
            "env": {
                "KG_AUTH_MODE": "<KG_AUTH_MODE>",
                "KG_DB_URL": "<KG_DB_URL>",
                "KG_DB_USER": "<KG_DB_USER>",
                "KG_DB_PASS": "<KG_DB_PASS>",
                "KG_JWT_SECRET": "<KG_JWT_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http src https://kg.kompl.yt/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e KG_AUTH_MODE=<KG_AUTH_MODE> -e KG_DB_URL=<KG_DB_URL> -e KG_DB_USER=<KG_DB_USER> -e KG_DB_PASS=<KG_DB_PASS> -e KG_JWT_SECRET=<KG_JWT_SECRET> src npx -y @komplyzen/komplyt-zero
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

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

## Примеры запросов агенту
- Зафиксируй решение использовать очередь задач на базе Postgres в проекте acme-api и укажи причину.
- Проверь по графу знаний, почему мы отказались от Redis для фоновой обработки.
- Создай сессию в графе знаний для сервиса вебхуков.

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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