# Knowl

Локальная память для ИИ-агентов: когда факт меняется, старый уходит в архив и не спорит с новым. Пригодится, если CLAUDE.md разросся и врёт.

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

## Что делает

Knowl хранит факты о проекте и отдаёт их агенту через MCP или CLI. Работает с кодом, исследованиями и бытовыми заметками. Ключ API не нужен, данные лежат локально.

Главная механика — вытеснение. Записали, что проект переехал на Postgres, — прежняя запись про MySQL перестаёт быть активной, и агент не выдаёт оба ответа сразу. Если Knowl не уверен, что новый факт заменяет старый, он оставляет обе записи и подсказывает команду `knowl supersede`. По замерам автора, без этого механизма качество поиска падает с 98% до 47%.

Ставится через `npm install -g @dat999zx/knowl`, дальше `knowl init` в каталоге проекта: создаётся `.knowl/`, дописывается `.gitignore`, регистрируются найденные агенты. Нужен Node.js 22 или новее. Внутри — нативные модули, поэтому запускать CLI напрямую под Bun или Deno не выйдет: Bun годится только для установки пакета.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://api.knowl.cloud/mcp/`

## Установка

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

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

2. **Командой платформы**
```bash
claude mcp add knowl -- npx -y @dat999zx/knowl
```

### Codex

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

2. **Командой платформы**
```bash
codex mcp add knowl -- npx -y @dat999zx/knowl
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "knowl": {
            "url": "https://api.knowl.cloud/mcp/"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "knowl": {
            "command": "npx",
            "args": [
                "-y",
                "@dat999zx/knowl"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "knowl": {
            "type": "http",
            "url": "https://api.knowl.cloud/mcp/"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "knowl": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@dat999zx/knowl"
            ]
        }
    }
}
```

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini mcp add knowl npx -y @dat999zx/knowl
```

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

## Примеры запросов агенту
- Какую базу данных использует этот проект? Посмотри в памяти Knowl.
- Запомни: мы перешли на Postgres, решение по MySQL больше не действует.
- Проверь через Knowl, что мы уже решили про авторизацию.

## Похожие
- [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
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32221

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