CPersona — MCP-сервер для Claude Code: что делает и как установить
Сохраняет контекст и решения проекта в локальной базе SQLite между сессиями ассистента без участия сторонних LLM.
claude mcp add --env CPERSONA_DB_PATH=<CPERSONA_DB_PATH> --env CPERSONA_EMBEDDING_MODE=<CPERSONA_EMBEDDING_MODE> --env CPERSONA_EMBEDDING_URL=<CPERSONA_EMBEDDING_URL> --env CPERSONA_RECALL_MODE=<CPERSONA_RECALL_MODE> --transport stdio cpersona -- uvx cpersonaЧто делает CPersona
Сервер организует долговременную память для кодинг-агентов через протокол MCP. Все записи о решениях, архитектуре и договорённостях сохраняются в единственный файл SQLite на вашем диске. Для извлечения применяется трёхслойный гибридный поиск с оценкой уверенности, а инструмент reconstruct возвращает цитаты из исходных записей.
Для работы требуется Python 3.11 или новее и утилита uvx. Чтобы задействовать векторный слой, разработчики рекомендуют поднять локальный сервис эмбеддингов через пакет cembedding. Если вы используете транспорт HTTP вместо стандартного потока stdio, сервер не запустится без токена CPERSONA_AUTH_TOKEN или флага CPERSONA_ALLOW_UNAUTHENTICATED_HTTP=true.
Какие задачи решает
- сохранять архитектурные решения между сессиями диалога
- находить контекст прошлых обсуждений через гибридный поиск
- подтверждать найденные факты прямыми цитатами через reconstruct
- хранить историю работы локально в одном файле базы данных
Примеры запросов агенту
- Запомни, почему мы выбрали PostgreSQL вместо MongoDB для этого сервиса.
- Вспомни архитектурные решения по модулю авторизации и приведи цитаты из записей.
- Какую схему именования маршрутов API мы утвердили на прошлой неделе?
Как установить CPersona
Командой платформы
claude mcp add --env CPERSONA_DB_PATH=<CPERSONA_DB_PATH> --env CPERSONA_EMBEDDING_MODE=<CPERSONA_EMBEDDING_MODE> --env CPERSONA_EMBEDDING_URL=<CPERSONA_EMBEDDING_URL> --env CPERSONA_RECALL_MODE=<CPERSONA_RECALL_MODE> --transport stdio cpersona -- uvx cpersonaВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cpersona <команда>
Командой платформы
codex mcp add cpersona --env CPERSONA_DB_PATH=<CPERSONA_DB_PATH> --env CPERSONA_EMBEDDING_MODE=<CPERSONA_EMBEDDING_MODE> --env CPERSONA_EMBEDDING_URL=<CPERSONA_EMBEDDING_URL> --env CPERSONA_RECALL_MODE=<CPERSONA_RECALL_MODE> -- uvx cpersonaВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cpersona <команда>
Файл настроек
{
"mcpServers": {
"cpersona": {
"command": "uvx",
"args": [
"cpersona"
],
"env": {
"CPERSONA_DB_PATH": "<CPERSONA_DB_PATH>",
"CPERSONA_EMBEDDING_MODE": "<CPERSONA_EMBEDDING_MODE>",
"CPERSONA_EMBEDDING_URL": "<CPERSONA_EMBEDDING_URL>",
"CPERSONA_RECALL_MODE": "<CPERSONA_RECALL_MODE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cpersona <команда>
Файл настроек
{
"servers": {
"cpersona": {
"type": "stdio",
"command": "uvx",
"args": [
"cpersona"
],
"env": {
"CPERSONA_DB_PATH": "<CPERSONA_DB_PATH>",
"CPERSONA_EMBEDDING_MODE": "<CPERSONA_EMBEDDING_MODE>",
"CPERSONA_EMBEDDING_URL": "<CPERSONA_EMBEDDING_URL>",
"CPERSONA_RECALL_MODE": "<CPERSONA_RECALL_MODE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cpersona <команда>
Командой платформы
gemini mcp add -e CPERSONA_DB_PATH=<CPERSONA_DB_PATH> -e CPERSONA_EMBEDDING_MODE=<CPERSONA_EMBEDDING_MODE> -e CPERSONA_EMBEDDING_URL=<CPERSONA_EMBEDDING_URL> -e CPERSONA_RECALL_MODE=<CPERSONA_RECALL_MODE> cpersona uvx cpersonaВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from cpersona <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о CPersona
Как установить CPersona в Claude Code?
Для стандартного запуска выполните claude mcp add cpersona -- uvx cpersona. Если требуется настроить переменные окружения для путей и поиска, используйте команду `claude mcp add --env CPERSONA_DB_PATH=<CPERSONA_DB_PATH> --env CPERSONA_EMBEDDING_MODE=<CPERSONA_EMBEDDING_MODE> --env CPERSONA_EMBEDDING_URL=<CPERSONA_EMBEDDING_URL> --env CPERSONA_RECALL_MODE=<CPERSONA_RECALL_MODE> --transport stdio cpersona -- uvx cpersona`.
Что делает CPersona?
Сервер даёт агенту 29 инструментов для записи и поиска контекста в локальном файле SQLite. Ранжирование и выборка выполняются напрямую через гибридный поиск без передачи запросов промежуточной языковой модели.
Нужен ли отдельный сервис для векторного поиска?
Да, для полноценного векторного слоя авторы советуют запустить локальный сервер cembedding с моделью jina-v5-nano на порту 8401. Без внешнего источника эмбеддингов векторная часть поиска останется неактивной.
