Waggle-mcp — MCP-сервер памяти для Claude Code и Codex
Локальная память проекта в виде графа: решения, причины и зависимости переживают перезапуск сессии. Пригодится, когда надоело каждый раз вставлять контекст заново.
claude mcp add --env WAGGLE_TRANSPORT=<WAGGLE_TRANSPORT> --env WAGGLE_BACKEND=<WAGGLE_BACKEND> --env WAGGLE_DB_PATH=<WAGGLE_DB_PATH> --env WAGGLE_DEFAULT_TENANT_ID=<WAGGLE_DEFAULT_TENANT_ID> --env WAGGLE_MODEL=<WAGGLE_MODEL> --transport stdio waggle-mcp -- uvx waggle-mcpЧто делает Waggle-mcp
Waggle хранит знания о проекте не в переписке, а в графе: что решили, почему, от чего это зависит и что поменялось. Агент достаёт нужный кусок, когда он понадобился, и записывает итоги для следующих разговоров. Основной цикл — prime_context подгружает контекст проекта, query_graph ищет историю, observe_conversation фиксирует результат, а build_context собирает компактный пакет под конкретную задачу.
Хранилище по умолчанию — SQLite на вашей машине, аккаунт Waggle и внешняя база для локальной работы не нужны. Граф можно посмотреть и поправить в Graph Studio, а перенести между клиентами — через файлы .abhi. В браузерном workspace агент только предлагает изменения, человек утверждает точный текст, прежде чем он станет основной версией памяти.
Пакету нужен Python 3.11+ и pipx. Одного подключения сервера мало: чтобы агент обращался к памяти сам, у клиента должны работать хуки, скиллы или инструкции проекта, которые вызывают эти инструменты. После pipx ensurepath перезапустите терминал, иначе команда waggle-mcp не найдётся.
Какие задачи решает
- восстановить контекст проекта в новой сессии без повторной вставки переписки
- зафиксировать решение и причину, по которой его приняли
- найти, от чего зависит конкретное требование и что на него влияет
- увидеть противоречия между старыми и новыми договорённостями
- перенести граф памяти в другой MCP-клиент
Примеры запросов агенту
- Загрузи контекст проекта через
prime_contextи коротко перескажи, на чём мы остановились - Найди в графе всё, что связано с выбором базы данных, и покажи историю этого решения
- Запиши через
observe_conversation, что мы решили перейти на PostgreSQL
Как установить Waggle-mcp
Командой платформы
claude mcp add --env WAGGLE_TRANSPORT=<WAGGLE_TRANSPORT> --env WAGGLE_BACKEND=<WAGGLE_BACKEND> --env WAGGLE_DB_PATH=<WAGGLE_DB_PATH> --env WAGGLE_DEFAULT_TENANT_ID=<WAGGLE_DEFAULT_TENANT_ID> --env WAGGLE_MODEL=<WAGGLE_MODEL> --transport stdio waggle-mcp -- uvx waggle-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from waggle-mcp <команда>
Командой платформы
codex mcp add waggle-mcp --env WAGGLE_TRANSPORT=<WAGGLE_TRANSPORT> --env WAGGLE_BACKEND=<WAGGLE_BACKEND> --env WAGGLE_DB_PATH=<WAGGLE_DB_PATH> --env WAGGLE_DEFAULT_TENANT_ID=<WAGGLE_DEFAULT_TENANT_ID> --env WAGGLE_MODEL=<WAGGLE_MODEL> -- uvx waggle-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from waggle-mcp <команда>
Файл настроек
{
"mcpServers": {
"waggle-mcp": {
"command": "uvx",
"args": [
"waggle-mcp"
],
"env": {
"WAGGLE_TRANSPORT": "<WAGGLE_TRANSPORT>",
"WAGGLE_BACKEND": "<WAGGLE_BACKEND>",
"WAGGLE_DB_PATH": "<WAGGLE_DB_PATH>",
"WAGGLE_DEFAULT_TENANT_ID": "<WAGGLE_DEFAULT_TENANT_ID>",
"WAGGLE_MODEL": "<WAGGLE_MODEL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from waggle-mcp <команда>
Файл настроек
{
"servers": {
"waggle-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"waggle-mcp"
],
"env": {
"WAGGLE_TRANSPORT": "<WAGGLE_TRANSPORT>",
"WAGGLE_BACKEND": "<WAGGLE_BACKEND>",
"WAGGLE_DB_PATH": "<WAGGLE_DB_PATH>",
"WAGGLE_DEFAULT_TENANT_ID": "<WAGGLE_DEFAULT_TENANT_ID>",
"WAGGLE_MODEL": "<WAGGLE_MODEL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from waggle-mcp <команда>
Командой платформы
gemini mcp add -e WAGGLE_TRANSPORT=<WAGGLE_TRANSPORT> -e WAGGLE_BACKEND=<WAGGLE_BACKEND> -e WAGGLE_DB_PATH=<WAGGLE_DB_PATH> -e WAGGLE_DEFAULT_TENANT_ID=<WAGGLE_DEFAULT_TENANT_ID> -e WAGGLE_MODEL=<WAGGLE_MODEL> waggle-mcp uvx waggle-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from waggle-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Waggle-mcp
Как установить Waggle-mcp в Claude Code?
Сначала поставьте пакет: pipx install waggle-mcp, затем pipx ensurepath и перезапустите терминал. После этого добавьте сервер командой claude mcp add waggle-mcp -- uvx waggle-mcp и перезапустите клиент.
Что делает Waggle-mcp?
Это MCP-сервер, который держит знания о проекте в графе и отдаёт их агенту по запросу. Решения, ограничения и предпочтения остаются доступны в следующих сессиях.
Память будет работать автоматически?
Нет. Инструменты должны вызываться хуками, скиллами или инструкциями проекта — сам факт подключения сервера агента к памяти не приучает.
