zep

yokthanwa1993/zep

3.1

If you are the rightful owner of zep and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Zep MCP Server is a Model Context Protocol Server designed for Claude Desktop, integrating with Zep Cloud API for enhanced memory and conversation management.

🚀 Zep MCP Server

MCP (Model Context Protocol) Server สำหรับ Claude Desktop ที่เชื่อมต่อกับ Zep Cloud API

✨ Features

  • MCP Server: รองรับ Claude Desktop
  • Zep Cloud Integration: เชื่อมต่อกับ Zep Cloud API
  • Memory Management: จัดการ memories และ conversations
  • SSE Transport: รองรับ Server-Sent Events
  • Docker Support: พร้อมสำหรับ containerization
  • CapRover Ready: พร้อมสำหรับ deployment บน CapRover

🏗️ Architecture

Claude Desktop ←→ MCP Server ←→ Zep Cloud API
                (FastMCP)      (Memory & Graph)

🚀 Quick Start

Local Development

# Clone repository
git clone <your-repo-url>
cd zep

# Install dependencies
pip install -r requirements.txt

# Set environment variables
cp env.example .env
# Edit .env with your API keys

# Run server
python core/zep_cloud_server_sse.py

Docker

# Build and run with Docker Compose
docker-compose up --build

# Or run with Docker
docker build -t zep-mcp-server .
docker run -p 8000:8000 --env-file .env zep-mcp-server

📋 Prerequisites

  • Python 3.10+
  • Zep Cloud API Key
  • OpenAI API Key (optional, for custom inference)

🔧 Configuration

Environment Variables

# Required
ZEP_API_KEY=your_zep_api_key

# Optional
OPENAI_API_KEY=your_openai_api_key
HOST=0.0.0.0
PORT=8000

Claude Desktop Config

{
    "mcpServers": {
        "zep-cloud": {
            "command": "python",
            "args": ["/path/to/core/zep_cloud_server_sse.py"]
        }
    }
}

🐳 Docker Deployment

Local Testing

docker-compose up --build

Production (CapRover)

  1. Build Docker image
  2. Upload to CapRover
  3. Set environment variables
  4. Deploy

📚 API Tools

  • User Management: Create, update, delete users
  • Conversation Management: Manage conversations and sessions
  • Memory Management: Add, search, and manage memories
  • Graph Operations: Work with knowledge graphs
  • Search: Semantic search across memories

🔍 Troubleshooting

Common Issues

  • Connection Failed: ตรวจสอบ ZEP_API_KEY
  • Port Conflicts: เปลี่ยน PORT ใน environment variables
  • Dependencies: รัน pip install -r requirements.txt

Logs

# View server logs
tail -f logs/server.log

# Docker logs
docker-compose logs -f

🤝 Contributing

  1. Fork the repository
  2. Create feature branch
  3. Make changes
  4. Submit pull request

📄 License

MIT License

🆘 Support

หากมีปัญหา:

  1. ตรวจสอบ logs
  2. ตรวจสอบ environment variables
  3. เปิด issue ใน GitHub

Happy Coding! 🎉