sayou — MCP-сервер для Claude Code: версионное хранилище контекста
Файловое хранилище контекста для ИИ-агентов: заметки, настройки и результаты исследований живут между сессиями как версионные markdown-файлы.
claude mcp add sayou -- uvx sayouЧто делает sayou
sayou даёт агенту рабочее пространство из файлов с YAML-frontmatter. Каждая запись — новая версия, старая остаётся, поэтому историю можно смотреть и сравнивать через unified diff. Чтение принимает token_budget: если файл длиннее, вернутся сводки со ссылками на секции, а не весь текст целиком.
Агент получает 11 инструментов MCP: запись и чтение файлов, список, поиск по тексту и frontmatter, glob, grep, мягкое удаление, история версий, хранилище ключ-значение с TTL, ссылки между файлами и работа с чанками. Двенадцатый, workspace_semantic_search, включается только при заданном SAYOU_EMBEDDING_PROVIDER.
Ставится двумя путями. Плагин Claude приносит хуки жизненного цикла и скиллы /ws, /save, /recall; если самого sayou ещё нет, он доустановится при первом запуске. Вариант с pip install даёт только инструменты MCP, без хуков и скиллов. Нужен Python 3.11 или новее. Проверка — sayou status: там видны путь к рабочему пространству, расположение базы и число зарегистрированных инструментов.
Какие задачи решает
- сохранить результаты исследования так, чтобы они не пропали после закрытия сессии
- найти заметку по метаданным frontmatter, а не по имени файла
- сравнить две версии документа и увидеть, что изменилось
- держать настройки агента в хранилище ключ-значение с истечением срока
- собрать связи между файлами в граф знаний
Примеры запросов агенту
- Сохрани заметку о целях на квартал со статусом draft
- Найди всё, что помечено status: draft
- Покажи diff между версиями файла
research/competitor-pricing.md
Как установить sayou
Командой платформы
claude mcp add sayou -- uvx sayouuvx запускает команду с именем пакета; если в README она другая — uvx --from sayou <команда>
Командой платформы
codex mcp add sayou -- uvx sayouuvx запускает команду с именем пакета; если в README она другая — uvx --from sayou <команда>
Файл настроек
{
"mcpServers": {
"sayou": {
"command": "uvx",
"args": [
"sayou"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from sayou <команда>
Файл настроек
{
"servers": {
"sayou": {
"type": "stdio",
"command": "uvx",
"args": [
"sayou"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from sayou <команда>
Командой платформы
gemini mcp add sayou uvx sayouuvx запускает команду с именем пакета; если в README она другая — uvx --from sayou <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о sayou
Как установить sayou в Claude Code?
Из терминала: claude plugin install sayou@pixell-global. Команда ставит плагин с хуками и скиллами, а сам sayou доустановится при первом запуске.
Что делает sayou?
Хранит контекст агента в версионных markdown-файлах с frontmatter и отдаёт их через 11 инструментов MCP — запись, чтение, поиск, история версий, ключ-значение.
Что нужно для семантического поиска?
Инструмент workspace_semantic_search работает только при заданной переменной окружения SAYOU_EMBEDDING_PROVIDER. Без неё доступны остальные инструменты.
