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

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

Обзор

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

Инструменты

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

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

Установка

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

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

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

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

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

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

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

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

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

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

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

Если сервер не может подключиться к 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. Он был протестирован с:

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

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

Разработка

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

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

Лицензия

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