MCP-сервер для Zep Cloud

MCP Server для Zep Cloud обеспечивает мост между клиентами LLM и API Zep Cloud, позволяя управлять памятью для помощников на основе искусственного интеллекта.

Обзор

Сервер MCP для хранения и извлечения воспоминаний пользователя, предпочтений, процедур и фактических отношений через API Zep Cloud. Он действует как семантический слой памяти, который позволяет помощникам ИИ поддерживать контекст о пользователях в разговорах.

Related MCP server: mcp-server-cloudbrowser

Инструменты

1. Управление пользователями :

   • create_user : создать нового пользователя в Zep Cloud

   • get_user : Получить данные о пользователе

   • update_user : обновить метаданные пользователя

   • delete_user : Удалить пользователя

   • list_users : Список всех пользователей

2. Операции с графиками :

   • search_graph : Поиск в графе памяти пользователя

   • add_graph_data : Добавить данные в график памяти пользователя

3. Связь :

   • check_connection : проверка состояния соединения с помощью API Zep Cloud

Переменные среды

Установка

Использование кузнечного дела

npx @smithery/cli install mcp-server-zep-cloud --client claude

Ручная установка с помощью Claude Desktop

1. Клонируйте этот репозиторий:

git clone https://github.com/yourusername/mcp-server-zep-cloud.git
cd mcp-server-zep-cloud

2. Установить зависимости:

pip install -r config/requirements.txt

3. Настройте Claude Desktop, добавив в claude_desktop_config.json :

{
  "mcpServers": {
    "zep-cloud": {
      "command": "python",
      "args": ["/path/to/mcp-server-zep-cloud/core/run_server.py"],
      "env": {
        "ZEP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Файл конфигурации находится по адресу:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Использование Докера

Для сборки и запуска сервера MCP доступен Dockerfile:

# Build the container
docker build -t mcp-server-zep-cloud .

# Run the container
docker run -p 8080:8080 \
  -e ZEP_API_KEY="your-api-key" \
  mcp-server-zep-cloud

Резервный режим

Если сервер не может подключиться к API Zep Cloud, он автоматически запускается в резервном режиме:

• Все операции API моделируются и возвращают успех.

• Фактические данные не отправляются и не принимаются через API Zep Cloud.

• Сервер остается работоспособным, обеспечивая функционирование клиентской интеграции.

• Предупреждающие сообщения регистрируются для указания резервного режима.

Структура репозитория

• core/ : Файлы основных функций

  • zep_cloud_client.py : реализация клиента для API Zep Cloud

  • zep_cloud_server.py : MCP-сервер, предоставляющий инструменты для доступа к API

  • run_server.py : Автономный скрипт для непосредственного запуска сервера

• scripts/ : Скрипты утилит для эксплуатации и тестирования

  • check_user_exists.py : Утилита для проверки существования пользователя

  • create_specific_user.py : Скрипт для создания тестовых пользователей

  • run_server.sh / run_server.bat : Скрипты оболочки для запуска сервера

• тесты/ : Тестовые скрипты

  • test_zep_cloud_client.py : Модульные тесты для клиента Zep Cloud

  • test_server_initialization_fixes.py : Тесты инициализации сервера

• config/ : Файлы конфигурации

  • .env.example : Шаблон для конфигурации среды

  • requirements.txt : Зависимости пакетов

Соображения безопасности

• Защита ключа API : никогда не передавайте свой ключ API в систему контроля версий.

• Переменные среды : используйте переменные среды для конфиденциальных данных.

• Ограниченный доступ : ограничение доступа к серверу доверенными сетями.

Поддержка других клиентов

Этот сервер MCP предназначен для работы с любым клиентом, совместимым с MCP. Он был протестирован с:

• Клод Десктоп

• Клод в веб-браузере

Разработка

Проведение тестов

cd tests
python test_zep_cloud_client.py
python test_server_initialization_fixes.py

Работа в режиме разработки

cd scripts
./run_server.sh

Лицензия

Этот сервер MCP лицензирован в соответствии с лицензией MIT.