# Khwan

Khwan сохраняет важные факты между сессиями и помогает передавать их субагентам. Это пригодится, если агенту нужно вспомнить решение или контекст из прошлой задачи.

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

## Что делает

Khwan подключает долговременную память к MCP-клиенту: агент может запросить факты по задаче через `khwan_recall` и сохранить новое решение через `khwan_remember`. Вместо старой стенограммы следующая сессия получает короткую подборку сведений. Память можно разделять по проектам и субагентам с помощью `KHWAN_CORE` и `KHWAN_USER`.

Внутри горячей сессии MCP добавляет сведения к контексту, поэтому сам по себе не сокращает расход токенов. В Claude Code автор рекомендует запрашивать память в начале сессии, а затем сохранять только устойчивые факты, а не повторять цикл на каждом ходе. Для подключения по HTTP используйте команду установки ниже. При локальном запуске через `uvx` потребуется `KHWAN_API_KEY`; не кладите его в проектный конфиг, который попадёт в репозиторий.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://mcp.khwan.ai/mcp/{core}/{user}`
- Переменные окружения: `KHWAN_API_KEY`, `KHWAN_CORE`, `KHWAN_USER`, `KHWAN_BASE_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы**
```bash
claude mcp add --env KHWAN_API_KEY=<KHWAN_API_KEY> --env KHWAN_CORE=<KHWAN_CORE> --env KHWAN_USER=<KHWAN_USER> --env KHWAN_BASE_URL=<KHWAN_BASE_URL> --transport stdio khwan -- uvx khwan-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from khwan-mcp <команда>

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http khwan-mcp https://mcp.khwan.ai/mcp/{core}/{user}
```

### Codex

1. **Командой платформы**
```bash
codex mcp add khwan --env KHWAN_API_KEY=<KHWAN_API_KEY> --env KHWAN_CORE=<KHWAN_CORE> --env KHWAN_USER=<KHWAN_USER> --env KHWAN_BASE_URL=<KHWAN_BASE_URL> -- uvx khwan-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from khwan-mcp <команда>

2. **Командой платформы: удалённый сервер**
```bash
codex mcp add khwan --url https://mcp.khwan.ai/mcp/{core}/{user}
```

### Cursor

1. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "khwan": {
            "command": "uvx",
            "args": [
                "khwan-mcp"
            ],
            "env": {
                "KHWAN_API_KEY": "<KHWAN_API_KEY>",
                "KHWAN_CORE": "<KHWAN_CORE>",
                "KHWAN_USER": "<KHWAN_USER>",
                "KHWAN_BASE_URL": "<KHWAN_BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from khwan-mcp <команда>

2. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "khwan": {
            "url": "https://mcp.khwan.ai/mcp/{core}/{user}"
        }
    }
}
```

### GitHub Copilot

1. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "khwan": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "khwan-mcp"
            ],
            "env": {
                "KHWAN_API_KEY": "<KHWAN_API_KEY>",
                "KHWAN_CORE": "<KHWAN_CORE>",
                "KHWAN_USER": "<KHWAN_USER>",
                "KHWAN_BASE_URL": "<KHWAN_BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from khwan-mcp <команда>

2. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "khwan": {
            "type": "http",
            "url": "https://mcp.khwan.ai/mcp/{core}/{user}"
        }
    }
}
```

### Gemini CLI

1. **Командой платформы**
```bash
gemini mcp add -e KHWAN_API_KEY=<KHWAN_API_KEY> -e KHWAN_CORE=<KHWAN_CORE> -e KHWAN_USER=<KHWAN_USER> -e KHWAN_BASE_URL=<KHWAN_BASE_URL> khwan uvx khwan-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from khwan-mcp <команда>

2. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http khwan https://mcp.khwan.ai/mcp/{core}/{user}
```

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

## Примеры запросов агенту
- Вспомни через `khwan_recall` решения по развёртыванию и используй их для этой задачи.
- Сохрани это решение проекта через `khwan_remember`.
- Передай субагенту краткую память по задаче через `khwan_recall`.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 392262
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119231

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

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