servidor mcp-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

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
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
Conectividad :
- check_connection : verifica el estado de la conexión con la API de Zep Cloud

Variables de entorno

Nombre	Descripción	Valor predeterminado
`ZEP_API_KEY`	Clave API para el servicio Zep Cloud	Ninguno
`MCP_HOST`	Host al que vincular el servidor	`0.0.0.0`
`MCP_PORT`	Puerto para ejecutar el servidor	`8080`

Instalación

Uso de herrería

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

Instalación manual con Claude Desktop

Clonar este repositorio:

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

Instalar dependencias:

pip install -r config/requirements.txt

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.

mcp-server-zep-cloud

Integrations