Gemdex — MCP-сервер памяти для Claude Code и других агентов
Слой постоянной памяти для ИИ-агентов: сохраняет заметки и находки, а потом находит их в другой сессии или репозитории.
claude mcp add --env GEMINI_API_KEY=<GEMINI_API_KEY> --env GEMDEX_MODE=<GEMDEX_MODE> --env LANCEDB_PATH=<LANCEDB_PATH> --env EMBEDDING_MODEL=<EMBEDDING_MODEL> --env GEMDEX_REMOTE_URL=<GEMDEX_REMOTE_URL> --transport stdio gemdex -- npx -y gemdex-mcpЧто делает Gemdex
Gemdex хранит небольшие фрагменты в локальной базе, ищет по ним гибридным способом — семантическое сходство плюс BM25 — и отдаёт агенту целые родительские записи. Сначала агент просматривает дешёвый индекс заголовков и открывает только нужное.
Запускается двумя способами. Локально это npx gemdex-mcp через stdio: эмбеддинги считает EmbeddingGemma 2 на устройстве, данные лежат в LanceDB под ~/.gemdex. Нужен Apple Silicon, macOS 14+ и нативный arm64 Node ≥24. Явная установка тянет управляемые Python/MLX и веса модели — около 1.45 GB скачать и 1.9 GB на диске. Ключ API не требуется, эмбеддинги работают офлайн. Node под Rosetta не поддерживается, это первое, обо что спотыкаются на старых Mac.
Второй вариант — self-hosted: подключение по Streamable HTTP /mcp, эмбеддинги на стороне сервера через Gemini, хранение в Postgres/pgvector и файловых или S3-блобах. Это отдельный пул, общий для нескольких машин. Вложения локально — картинки, аудио до 5 минут и видео; PDF не поддерживается. Для разбора истории чатов и гигиены памяти нужен вход в Claude: claude auth login.
Какие задачи решает
- сохранить удачный разбор бага и вернуть его в новом репозитории
- найти в памяти скриншот или запись, о которой помнишь только смысл
- обновить устаревшую заметку, не заводя вторую
- пометить, сработала ли подсказка из памяти
- разобрать историю сессий Claude в дайджесты
Примеры запросов агенту
- Сохрани в память, как мы настроили процесс ревью.
- Поищи в памяти наш процесс ревью и примени его здесь.
- Проверь память: нет ли там чего-то про этот скриншот?
Как установить Gemdex
Командой платформы
claude mcp add --env GEMINI_API_KEY=<GEMINI_API_KEY> --env GEMDEX_MODE=<GEMDEX_MODE> --env LANCEDB_PATH=<LANCEDB_PATH> --env EMBEDDING_MODEL=<EMBEDDING_MODEL> --env GEMDEX_REMOTE_URL=<GEMDEX_REMOTE_URL> --transport stdio gemdex -- npx -y gemdex-mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Командой платформы
codex mcp add gemdex --env GEMINI_API_KEY=<GEMINI_API_KEY> --env GEMDEX_MODE=<GEMDEX_MODE> --env LANCEDB_PATH=<LANCEDB_PATH> --env EMBEDDING_MODEL=<EMBEDDING_MODEL> --env GEMDEX_REMOTE_URL=<GEMDEX_REMOTE_URL> -- npx -y gemdex-mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"gemdex": {
"command": "npx",
"args": [
"-y",
"gemdex-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"GEMDEX_MODE": "<GEMDEX_MODE>",
"LANCEDB_PATH": "<LANCEDB_PATH>",
"EMBEDDING_MODEL": "<EMBEDDING_MODEL>",
"GEMDEX_REMOTE_URL": "<GEMDEX_REMOTE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"gemdex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gemdex-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"GEMDEX_MODE": "<GEMDEX_MODE>",
"LANCEDB_PATH": "<LANCEDB_PATH>",
"EMBEDDING_MODEL": "<EMBEDDING_MODEL>",
"GEMDEX_REMOTE_URL": "<GEMDEX_REMOTE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> -e GEMDEX_MODE=<GEMDEX_MODE> -e LANCEDB_PATH=<LANCEDB_PATH> -e EMBEDDING_MODEL=<EMBEDDING_MODEL> -e GEMDEX_REMOTE_URL=<GEMDEX_REMOTE_URL> gemdex npx -y gemdex-mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Gemdex
Как установить Gemdex в Claude Code?
Сначала npx gemdex-mcp install, затем claude mcp add gemdex -- npx -y gemdex-mcp@latest. После установки переподключите MCP-клиент.
Что делает Gemdex?
Даёт агенту постоянную память: сохранение, поиск и обновление записей, которые переживают смену сессии и репозитория.
Нужен ли ключ API для локального режима?
Нет. Эмбеддинги считаются на устройстве и после установки работают офлайн. Ключ Gemini нужен только для self-hosted варианта.
