mcp-server-zep-cloud

Servidor MCP para Zep Cloud

El servidor MCP para Zep Cloud proporciona un puente entre los clientes LLM y la API de Zep Cloud, lo que permite la gestión de memoria para los asistentes de IA.

Descripción general

Un servidor MCP para almacenar y recuperar recuerdos, preferencias, procedimientos y relaciones factuales del usuario a través de la API de Zep Cloud. Actúa como una capa de memoria semántica que permite a los asistentes de IA mantener el contexto de los usuarios en todas las conversaciones.

Herramientas

1. Gestión de usuarios :
   • create_user : Crea un nuevo usuario en Zep Cloud
   • get_user : Obtener detalles de un usuario
   • update_user : Actualizar los metadatos de un usuario
   • delete_user : Eliminar un usuario
   • list_users : Listar todos los usuarios
2. Operaciones gráficas :
   • search_graph : Busca en el gráfico de memoria de un usuario
   • add_graph_data : Agrega datos al gráfico de memoria de un usuario
3. Conectividad :
   • check_connection : verifica el estado de la conexión con la API de Zep Cloud

Variables de entorno

Instalación

Uso de herrería

Instalación manual con Claude Desktop

1. Clonar este repositorio:

2. Instalar dependencias:

3. Configure Claude Desktop agregando a claude_desktop_config.json :

El archivo de configuración se encuentra en:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Ventanas: %APPDATA%\Claude\claude_desktop_config.json

Usando Docker

Hay un Dockerfile disponible para crear y ejecutar el servidor MCP:

Modo de respaldo

Si el servidor no puede conectarse a la API de Zep Cloud, se inicia automáticamente en modo de respaldo:

• Todas las operaciones de API se simulan y devuelven resultados exitosos.
• No se envían ni se reciben datos reales de la API de Zep Cloud
• El servidor permanece operativo, lo que permite que funcione la integración del cliente.
• Se registran mensajes de advertencia para indicar el modo de respaldo

Estructura del repositorio

• core/ : Archivos de funcionalidad principal
  • zep_cloud_client.py : Implementación del cliente para la API de Zep Cloud
  • zep_cloud_server.py : servidor MCP que proporciona herramientas para el acceso a la API
  • run_server.py : script independiente para ejecutar el servidor directamente
• scripts/ : Scripts de utilidad para operaciones y pruebas
  • check_user_exists.py : Utilidad para comprobar si un usuario existe
  • create_specific_user.py : Script para crear usuarios de prueba
  • run_server.sh / run_server.bat : Scripts de shell para ejecutar el servidor
• pruebas/ : Scripts de prueba
  • test_zep_cloud_client.py : Pruebas unitarias para el cliente Zep Cloud
  • test_server_initialization_fixes.py : Pruebas de inicialización del servidor
• config/ : Archivos de configuración
  • .env.example : Plantilla para la configuración del entorno
  • requirements.txt : Dependencias del paquete

Consideraciones de seguridad

• Protección de clave API : nunca envíe su clave API al control de versiones
• Variables de entorno : utilice variables de entorno para datos confidenciales
• Acceso restringido : Limite el servidor a redes confiables

Soporte para otros clientes

Este servidor MCP está diseñado para funcionar con cualquier cliente compatible con MCP. Se ha probado con:

• Escritorio de Claude
• Claude en el navegador web

Desarrollo

Ejecución de pruebas

Ejecutando en modo de desarrollo

Licencia

Este servidor MCP tiene licencia MIT.