# Cathedral — Persistent Memory for AI Agents

Сохраняет контекст, цели и опыт ИИ-агента между сессиями и перезапусками среды. Отслеживает дрифт поведения с помощью криптографических слепков памяти.

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

## Что делает

Сервер решает проблему холодного старта языковых моделей. Инструмент `cathedral_wake` восстанавливает профиль агента, его актуальные задачи и контекст одной командой. Воспоминания записываются через `cathedral_remember` с указанием категорий и весов важности, после чего их можно искать по тексту или тегам.

Для контроля стабильности сервер вычисляет SHA-256 хэш корпуса памяти. Вызов `cathedral_snapshot` фиксирует контрольную точку, а `cathedral_drift` показывает отклонение от базового состояния по шкале от 0.0 до 1.0. Это помогает вовремя заметить искажение поведения после смены модели.

Без действующего ключа `CATHEDRAL_API_KEY` облачный эндпоинт отклонит запросы. Если настроить переменную `CATHEDRAL_SANITISE` со значением `1`, сервер начнёт вырезать потенциальные промпт-инъекции из содержимого памяти. Также доступен локальный запуск через `cathedral-server`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://cathedral-ai.com/mcp`
- Переменные окружения: `CATHEDRAL_API_KEY`, `CATHEDRAL_BASE_URL`, `CATHEDRAL_SANITISE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

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

2. **Командой платформы**
```bash
claude mcp add --env CATHEDRAL_API_KEY=<CATHEDRAL_API_KEY> --env CATHEDRAL_BASE_URL=<CATHEDRAL_BASE_URL> --env CATHEDRAL_SANITISE=<CATHEDRAL_SANITISE> --transport stdio mcp-server -- uvx cathedral-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cathedral-mcp <команда>

### Codex

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

2. **Командой платформы**
```bash
codex mcp add mcp-server --env CATHEDRAL_API_KEY=<CATHEDRAL_API_KEY> --env CATHEDRAL_BASE_URL=<CATHEDRAL_BASE_URL> --env CATHEDRAL_SANITISE=<CATHEDRAL_SANITISE> -- uvx cathedral-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cathedral-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "url": "https://cathedral-ai.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "uvx",
            "args": [
                "cathedral-mcp"
            ],
            "env": {
                "CATHEDRAL_API_KEY": "<CATHEDRAL_API_KEY>",
                "CATHEDRAL_BASE_URL": "<CATHEDRAL_BASE_URL>",
                "CATHEDRAL_SANITISE": "<CATHEDRAL_SANITISE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cathedral-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "http",
            "url": "https://cathedral-ai.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "cathedral-mcp"
            ],
            "env": {
                "CATHEDRAL_API_KEY": "<CATHEDRAL_API_KEY>",
                "CATHEDRAL_BASE_URL": "<CATHEDRAL_BASE_URL>",
                "CATHEDRAL_SANITISE": "<CATHEDRAL_SANITISE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cathedral-mcp <команда>

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini mcp add -e CATHEDRAL_API_KEY=<CATHEDRAL_API_KEY> -e CATHEDRAL_BASE_URL=<CATHEDRAL_BASE_URL> -e CATHEDRAL_SANITISE=<CATHEDRAL_SANITISE> mcp-server uvx cathedral-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cathedral-mcp <команда>

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

## Примеры запросов агенту
- Восстанови свой контекст и текущие цели через cathedral_wake
- Сохрани в память решение сфокусироваться на стабильности API с категорией goal
- Сделай снимок состояния памяти и проверь текущий уровень дрифта

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

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