Mem0 MCP-сервер
Сервер протокола контекста модели (MCP) для интеграции помощников на основе искусственного интеллекта с системой постоянной памяти Mem0.ai.
Обзор
Этот сервер предоставляет MCP-совместимые инструменты, которые позволяют любому совместимому помощнику ИИ получать доступ и управлять постоянными воспоминаниями, хранящимися в Mem0. Он действует как мост между моделями ИИ и системой памяти Mem0, позволяя помощникам:
- Сохраняйте и извлекайте воспоминания
- Поиск воспоминаний с семантическим сходством
- Управлять различными типами памяти (эпизодической, семантической, процедурной)
- Используйте кратковременную память для контекста разговора
- Применяйте избирательные паттерны памяти
- Создавайте графики знаний из воспоминаний
Структура проекта
Код проекта находится в каталоге src/mcp_mem0_general/ .
Начало работы (установка не требуется!)
Этот сервер можно запустить непосредственно из GitHub с помощью uvx , без необходимости клонирования репозитория или его локальной установки.
Запуск сервера
Убедитесь, что у вас установлен uv ( pipx install uv или brew install uv ).
Вы можете протестировать сервер прямо в своем терминале:
# Make sure MEM0_API_KEY is set in your environment
export MEM0_API_KEY="your-mem0-api-key-here"
# Run the server using uvx
uvx git+https://github.com/ryaker/mcp-mem0-general.git mcp-mem0-general
Сервер должен запуститься и зарегистрировать этапы своей инициализации.
Настройка в Курсоре или Клоде Десктопе
- Найти путь
uvx : GUI-приложения, такие как Claude Desktop, часто не используют тот же PATH , что и ваш терминал. Найдите полный путь к исполняемому файлу uvx , запустив это в терминале:Скопируйте выходной путь (например, /Users/yourname/.local/bin/uvx или /opt/homebrew/bin/uvx ). - Настройте MCP: добавьте следующую конфигурацию в файл конфигурации MCP, заменив
/full/path/to/uvx фактическим путем, который вы нашли на шаге 1.- Курсор: Добавить/обновить в
~/.cursor/mcp.json : - Claude Desktop: Добавьте/обновите аналогичную конфигурацию в своих настройках.
"mem0-memory-general": {
"command": "/full/path/to/uvx", # <-- IMPORTANT: Use the full path from 'which uvx'
"args": [
"git+https://github.com/ryaker/mcp-mem0-general.git",
"mcp-mem0-general"
],
"env": {
"MEM0_API_KEY": "your-mem0-api-key-here"
}
}
- Перезапуск: Перезапустите Cursor или Claude Desktop, чтобы применить изменения. Теперь сервер должен запуститься правильно в приложении.
Примечание по mem0ai[neo4j] Предупреждение
Вы можете увидеть предупреждение вроде warning: The package mem0ai==0.1.96 does not have an extra named neo4j во время запуска.
- При использовании управляемой платформы Mem0.ai: Это предупреждение можно смело игнорировать. Необходимая обработка графа происходит на стороне сервера на платформе Mem0.
- Если вы размещаете Mem0 самостоятельно с Neo4j: это предупреждение указывает на то, что конкретная версия
mem0ai не установила автоматически библиотеки Python, связанные с Neo4j ( langchain-neo4j , neo4j ). Вам необходимо убедиться, что они установлены вручную в вашей среде самостоятельного размещения, если вы используете функции графа.
Загрузка руководства по использованию в память (рекомендуется)
Чтобы вашему помощнику AI было проще ссылаться на возможности сервера, вы можете загрузить содержимое USAGE_GUIDE.md в Mem0. Выполните следующие действия:
Предварительное условие: убедитесь, что сервер Mem0 MCP запущен и правильно настроен в вашем помощнике AI (Claude/Cursor), как описано в разделе «Начало работы» выше.
- Копирование содержимого руководства: Откройте файл USAGE_GUIDE.md . Выделите и скопируйте все его текстовое содержимое.
- Попросите помощника добавить память: перейдите к своему помощнику AI (Клод/Курсор) и используйте подсказку, похожую на эту, вставив скопированное вами содержимое руководства в указанное место. Обязательно используйте свой постоянный
user_id (например, "default_user").
Пожалуйста, запомните следующее руководство по использованию сервера Mem0 MCP. Используйте user_id "default_user" и добавьте метаданные {"title": "Mem0 MCP Usage Guide", "source": "README Instruction"} :
[--- ВСТАВЬТЕ ВЕСЬ КОНТЕНТ USAGE_GUIDE.md ЗДЕСЬ ---]
The assistant should call the `mem0_add_memory` tool.
3. **Find the Memory ID:** Once the assistant confirms the memory is added, ask it to find the specific ID for that memory:
```
Please search my memories for user_id "default_user" using the query "Mem0 MCP Usage Guide" and tell me the exact memory ID of that guide memory you just added.
The assistant should use the `mem0_search_memory` tool and provide you with an ID string (e.g., `76100ac4-896e-488b-90ad-036c0dfaaa80`). **Note down this ID!**
- Получите руководство позже: Теперь, когда у вас есть идентификатор, вы можете быстро попросить своего помощника вызвать полное руководство в любое время, используя такую подсказку:
```
First execute Retrieve memory ID *your-guide-id-here* using mem0_get_memory_by_id. Then return control to me.
```
(Replace *`your-guide-id-here`* with the actual ID you noted down in step 3).
Типы памяти
Сервер поддерживает различные типы памяти, организованные по длительности и функциям:
Кратковременные воспоминания
- Память разговора : вызов недавних сообщений
- Рабочая память : Временная информация, которая активно используется
- Внимание Память : Информация, находящаяся в фокусе в данный момент
Долгосрочные воспоминания
- Эпизодическая память : Конкретные события и переживания
- Семантическая память : факты, концепции и знания
- Процедурная память : навыки и практическая информация
Расширенные функции
- Пользовательские категории : определение и управление собственными категориями памяти.
- Инструкции по запоминанию : установите правила обработки воспоминаний.
- Графические связи : доступ к графическим связям между сущностями
- Избирательная память : фильтрация текста с использованием шаблонов включения/исключения перед сохранением
- Механизм обратной связи : предоставление отзывов о качестве памяти.
Использование
Все воспоминания в системе используют «default_user» в качестве user_id по умолчанию.
Подробные примеры использования см. в USAGE_GUIDE.md .
Документация
Лицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .
Благодарности