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.

Related MCP server: Frinus MCP Server

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

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

Instalación manual con Claude Desktop

1. Clonar este repositorio:

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

2. Instalar dependencias:

pip install -r config/requirements.txt

3. Configure Claude Desktop agregando a 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"
      }
    }
  }
}

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:

# 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

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

cd tests
python test_zep_cloud_client.py
python test_server_initialization_fixes.py

Ejecutando en modo de desarrollo

cd scripts
./run_server.sh

Licencia

Este servidor MCP tiene licencia MIT.