mcp-сервер-zep-облако

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

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

Обзор

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

Инструменты

Управление пользователями :
- create_user : создать нового пользователя в Zep Cloud
- get_user : Получить данные о пользователе
- update_user : обновить метаданные пользователя
- delete_user : Удалить пользователя
- list_users : Список всех пользователей
Операции с графиками :
- search_graph : Поиск в графе памяти пользователя
- add_graph_data : Добавить данные в график памяти пользователя
Связь :
- check_connection : проверка состояния соединения с помощью API Zep Cloud

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

Имя	Описание	Значение по умолчанию
`ZEP_API_KEY`	API-ключ для сервиса Zep Cloud	Никто
`MCP_HOST`	Хост, к которому будет привязан сервер	`0.0.0.0`
`MCP_PORT`	Порт для запуска сервера	`8080`

Установка

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

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

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

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

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

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

pip install -r config/requirements.txt

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

mcp-server-zep-cloud

Integrations