🧠 Prism MCP — Дворец памяти для ИИ-агентов

Ваш ИИ-агент забывает всё между сессиями. Prism исправляет это — а затем учит его думать.

Prism v7.8 — это настоящая когнитивная архитектура, вдохновленная механикой человеческого мозга. Помимо простого векторного поиска, ваш агент теперь формирует принципы на основе опыта, следует причинно-следственным цепочкам мыслей и обладает самосознанием, чтобы понимать, когда ему не хватает информации. Ваши агенты не просто помнят; они учатся.

npx -y prism-mcp-server

Работает с Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Gemini · Antigravity — любым MCP-клиентом.

https://github.com/dcostenco/prism-mcp/raw/main/docs/prism_mcp_demo.mp4

📖 Содержание

• Почему Prism?

• Быстрый старт

• Магический момент

• Руководства по настройке

• Универсальный импорт: перенос истории

• Что отличает Prism

• Когнитивная архитектура (v7.8)

• Конфиденциальность данных и передача

• Варианты использования

• Что нового

• Сравнение Prism

• Справочник CLI

• Справочник инструментов

• Переменные окружения

• Архитектура

• Научная основа

• Вехи и дорожная карта

• Часто задаваемые вопросы (FAQ)

Почему Prism?

Каждый раз, когда вы начинаете новый разговор с ИИ-помощником по программированию, он начинает с нуля. Вы заново объясняете архитектуру, описываете решения, перечисляете TODO. Часы контекста — исчезают.

Prism дает вашему агенту мозг, который сохраняется — а затем учит его рассуждать. Сохраняйте важное в конце каждой сессии. Загружайте это мгновенно в следующей. Но Prism идет гораздо дальше хранения: он консолидирует сырой опыт в устойчивые принципы, проходит по причинно-следственным цепочкам для выявления первопричин и знает, когда сказать: «Я не знаю».

📌 Терминология: В этом документе «Prism» относится к MCP-серверу и движку когнитивной памяти. «Дворец памяти» (Mind Palace) относится к визуальному дашборду на localhost:3000 — вашему окну в мозг агента. Они работают вместе; дашборд опционален.

У Prism три столпа:

1. 🧠 Когнитивная память — Воспоминания ранжируются как в человеческом мозге: недавно и часто используемый контекст всплывает первым, а устаревший контекст естественным образом затухает через распад активации ACT-R. Сырой опыт консолидируется в семантические принципы через обучение Хебба. Результат — качество поиска, с которым не сравнится никакой плоский векторный поиск. (См. Когнитивная архитектура и Научная основа.)

2. 🔗 Многоходовые рассуждения — Когда ваш агент ищет «Ошибка X», Prism не просто находит логи с упоминанием «Ошибка X». Распространение активации проходит по причинно-следственному графу и возвращает «Обходной путь Y», который связан с «Архитектурным решением Z» — это буквально ход мыслей. (См. Когнитивная архитектура.)

3. 🏭 Автономное исполнение (Dark Factory) — Когда вы будете готовы, Prism может выполнять задачи по программированию от начала до конца с помощью конвейера с закрытием при сбое, где состязательный оценщик ловит ошибки, пропущенные генератором — еще до того, как вы увидите PR. (См. Dark Factory.)

🚀 Быстрый старт

Предварительные требования

• Node.js v18+ (рекомендуется v20 LTS; v23.x имеет известную особенность npx)

• Любой MCP-совместимый клиент (Claude Desktop, Cursor, Windsurf, Cline и т.д.)

• Для основных функций ключи API не требуются (см. Матрицу возможностей)

Установка

Добавьте в конфигурацию вашего MCP-клиента (claude_desktop_config.json, .cursor/mcp.json и т.д.):

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"]
    }
  }
}

⚠️ Windows / Ограниченные оболочки: Если ваш MCP-клиент жалуется, что npx не найден, используйте абсолютный путь к вашему бинарному файлу node (например, C:\Program Files\nodejs\npx.cmd).

Это всё. Перезапустите клиент. Все инструменты доступны. Дашборд «Дворец памяти» (визуальный интерфейс для мозга вашего агента) запускается автоматически на http://localhost:3000. Вам не нужно держать вкладку открытой — дашборд работает в фоновом режиме, а инструменты MCP работают с ним или без него.

🔮 Совет: После установки откройте http://localhost:3000 в браузере, чтобы увидеть дашборд «Дворец памяти» — красивый интерфейс мозга вашего агента в реальном времени. Исследуйте граф знаний, индикаторы состояния намерений и журнал сессий.

🔄 Обновление Prism: npx -y кэширует пакет локально. Чтобы принудительно обновиться до последней версии, перезапустите MCP-клиент — npx -y автоматически загрузит новый релиз. Если вы застряли на старой версии, выполните npx clear-npx-cache (или npm cache clean --force) перед перезапуском.

Добавьте PRISM_DASHBOARD_PORT в блок env конфигурации MCP:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"],
      "env": { "PRISM_DASHBOARD_PORT": "3001" }
    }
  }
}

Затем откройте http://localhost:3001.

Матрица возможностей

🔑 Основной «Дворец памяти» работает на 100% оффлайн без ключей API. Облачные ключи открывают интеллектуальные функции. См. Переменные окружения.

💰 Примечание о стоимости API: GOOGLE_API_KEY (Gemini) имеет щедрый бесплатный уровень, покрывающий большинство индивидуальных нужд. BRAVE_API_KEY предлагает 2000 бесплатных поисков в месяц. FIRECRAWL_API_KEY имеет бесплатный план на 500 кредитов. Для типичной одиночной разработки ожидайте $0/мес на бесплатных уровнях. Только высоконагруженные команды или интенсивное использование автономных конвейеров повлекут значительные расходы.

✨ Магический момент

Сессия 1 (вечер понедельника):

You: "Analyze this auth architecture and plan the OAuth migration."
Agent: *deep analysis, decisions, TODO list*
Agent: session_save_ledger → session_save_handoff ✅

Сессия 2 (утро вторника — новый разговор, новое окно контекста):

Agent: session_load_context → "Welcome back! Yesterday we decided to use PKCE
       flow with refresh tokens. 3 TODOs remain: migrate the user table,
       update the middleware, and write integration tests."
You: "Pick up where we left off."

Ваш агент помнит всё. Никакой повторной загрузки файлов. Никаких повторных объяснений решений.

📖 Руководства по настройке

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"]
    }
  }
}

Добавьте в .cursor/mcp.json (проект) или ~/.cursor/mcp.json (глобально):

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"]
    }
  }
}

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"]
    }
  }
}

Добавьте в ваш config.json Continue или настройки MCP Cline:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"],
      "env": {
        "PRISM_STORAGE": "local",
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

Claude Code естественным образом подхватывает инструменты MCP, добавляя их в .clauderules вашего рабочего пространства. Просто добавьте:

Always start the conversation by calling `mcp__prism-mcp__session_load_context(project='my-project', level='deep')`.
When wrapping up, always call `mcp__prism-mcp__session_save_ledger` and `mcp__prism-mcp__session_save_handoff`.

Примечание по формату: Claude автоматически оборачивает инструменты MCP двойным подчеркиванием (mcp__prism-mcp__...), в то время как большинство других клиентов используют одинарное (mcp_prism-mcp_...). Бэкенд Prism нативно поддерживает оба формата.

Альтернатива CLI: Если инструменты MCP недоступны или вы пишете скрипты вокруг Claude Code:

# Load context before a session
prism load my-project --level deep

# Machine-readable JSON for parsing in scripts
prism load my-project --level deep --json

См. Руководство по настройке Gemini для проверенной трехуровневой архитектуры промптов, обеспечивающей надежную автозагрузку сессий.

Antigravity не предоставляет инструменты MCP модели. Используйте CLI prism load в качестве резервного варианта:

# From a shell or run_command tool
prism load my-project --level standard --json

# Or via the wrapper script
bash ~/.gemini/antigravity/scratch/prism_session_loader.sh my-project

CLI использует тот же уровень хранения, что и инструмент MCP (SQLite или Supabase).

⚠️ КРИТИЧЕСКИ ВАЖНО (v9.2.2): Предотвращение «расщепления мозга» Если ваш MCP-сервер настроен с PRISM_STORAGE=local, но также установлены учетные данные Supabase, CLI может читать из неправильного бэкенда (Supabase), в то время как сервер пишет в SQLite. Это вызывает устаревание TODO и расхождение состояний. Всегда явно передавайте --storage local при использовании CLI в режиме локальной среды:

prism load my-project --storage local --json

Обертка prism_session_loader.sh обрабатывает это автоматически начиная с v9.2.2.

Используйте CLI prism load для доступа к контексту сессии из любой оболочки:

# Quick check — human-readable
prism load my-project

# Parse JSON in scripts
CONTEXT=$(prism load my-project --level quick --json)
SUMMARY=$(echo "$CONTEXT" | jq -r '.handoff[0].last_summary')
VERSION=$(echo "$CONTEXT" | jq -r '.handoff[0].version')
echo "Project at v$VERSION: $SUMMARY"

# Explicit storage backend (v9.2.2 — prevents split-brain)
prism load my-project --storage local --json
prism load my-project --storage supabase --json

# Role-scoped loading
prism load my-project --role qa --json

# Use in CI/CD to verify context exists before deploying
if ! prism load my-project --level quick --json | jq -e '.handoff[0].version' > /dev/null 2>&1; then
  echo "No Prism context found — skipping context-aware deploy"
fi

📦 Установка: npm install -g prism-mcp-server делает CLI prism доступным глобально. Для локальных сборок: node /path/to/prism/dist/cli.js load.

Для синхронизации памяти между машинами или командами:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"],
      "env": {
        "PRISM_STORAGE": "supabase",
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_KEY": "your-supabase-anon-or-service-key"
      }
    }
  }
}

Миграции схемы

Prism автоматически применяет свою схему при первом подключении — ручной шаг не требуется. Если вам нужно применить или повторно применить миграции вручную (например, для нового проекта или после обновления версии), запустите SQL-файлы в supabase/migrations/ в нумерованном порядке через SQL-редактор Supabase или CLI:

# Via CLI (requires supabase CLI + project linked)
supabase db push

# Or apply a single migration via the Supabase dashboard SQL Editor
# Paste the contents of supabase/migrations/0NN_*.sql and click Run

Ключевые миграции:

• 020_* — Основная схема (журнал, передача, FTS, TTL, CRDT)

• 033_memory_links.sql — Граф ассоциативной памяти (MemoryLinks) — требуется для session_backfill_links

Anon key vs. service role key: Anon key работает для личного использования (применяются политики RLS Supabase). Используйте service role key для командных развертываний, где несколько пользователей делят один проект Supabase — он обходит RLS и позволяет Prism управлять всеми строками независимо от контекста аутентификации. Никогда не раскрывайте service role key на стороне клиента.

git clone https://github.com/dcostenco/prism-mcp.git
cd prism-mcp && npm install && npm run build

Затем добавьте в вашу конфигурацию MCP:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "node",
      "args": ["/path/to/prism-mcp/dist/server.js"],
      "env": {
        "BRAVE_API_KEY": "your-key",
        "GOOGLE_API_KEY": "your-gemini-key"
      }
    }
  }
}