Mem0 MCP-сервер

Сервер протокола контекста модели (MCP) для интеграции помощников на основе искусственного интеллекта с системой постоянной памяти Mem0.ai.

Обзор

Этот сервер предоставляет MCP-совместимые инструменты, которые позволяют любому совместимому помощнику ИИ получать доступ и управлять постоянными воспоминаниями, хранящимися в Mem0. Он действует как мост между моделями ИИ и системой памяти Mem0, позволяя помощникам:

• Сохраняйте и извлекайте воспоминания

• Поиск воспоминаний с семантическим сходством

• Управлять различными типами памяти (эпизодической, семантической, процедурной)

• Используйте кратковременную память для контекста разговора

• Применяйте избирательные паттерны памяти

• Создавайте графики знаний из воспоминаний

Related MCP server: AGI MCP Server

Структура проекта

Код проекта находится в каталоге 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

Сервер должен запуститься и зарегистрировать этапы своей инициализации.

Настройка в Курсоре или Клоде Десктопе

1. Найти путь uvx : GUI-приложения, такие как Claude Desktop, часто не используют тот же PATH , что и ваш терминал. Найдите полный путь к исполняемому файлу uvx , запустив это в терминале:

   which uvx

   Скопируйте выходной путь (например, /Users/yourname/.local/bin/uvx или /opt/homebrew/bin/uvx ).

2. Настройте 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"
     }
   }

3. Перезапуск: Перезапустите 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), как описано в разделе «Начало работы» выше.

1. Копирование содержимого руководства: Откройте файл USAGE_GUIDE.md . Выделите и скопируйте все его текстовое содержимое.

2. Попросите помощника добавить память: перейдите к своему помощнику 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!**

4. Получите руководство позже: Теперь, когда у вас есть идентификатор, вы можете быстро попросить своего помощника вызвать полное руководство в любое время, используя такую подсказку:

```
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 .

Документация

• Начиная

• Ссылка на API

• Типы памяти

• Расширенные функции

• Конфигурация

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Благодарности

• Mem0.ai за их превосходный API памяти

• Модель контекстного протокола (и его Python SDK mcp ) для реализации сервера

• Все участники этого проекта