mcp-server-zep-cloud

Zep Cloud용 MCP 서버

Zep Cloud용 MCP 서버는 LLM 클라이언트와 Zep Cloud API를 연결하여 AI 어시스턴트의 메모리 관리를 가능하게 합니다.

개요

Zep Cloud API를 통해 사용자 기억, 선호도, 절차 및 사실 관계를 저장하고 검색하는 MCP 서버입니다. AI 비서가 대화 전반에 걸쳐 사용자에 대한 맥락을 유지할 수 있도록 하는 의미적 메모리 계층 역할을 합니다.

도구

1. 사용자 관리 :
   • create_user : Zep Cloud에 새 사용자를 생성합니다.
   • get_user : 사용자 세부 정보를 가져옵니다
   • update_user : 사용자의 메타데이터를 업데이트합니다.
   • delete_user : 사용자 삭제
   • list_users : 모든 사용자 나열
2. 그래프 연산 :
   • search_graph : 사용자의 메모리 그래프를 검색합니다.
   • add_graph_data : 사용자 메모리 그래프에 데이터 추가
3. 연결성 :
   • check_connection : Zep Cloud API를 사용하여 연결 상태를 확인합니다.

환경 변수

설치

대장간 사용

지엑스피1

Claude Desktop을 사용한 수동 설치

1. 이 저장소를 복제하세요:

2. 종속성 설치:

3. claude_desktop_config.json 에 다음을 추가하여 Claude Desktop을 구성합니다.

구성 파일은 다음 위치에 있습니다.

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

Docker 사용

MCP 서버를 빌드하고 실행하려면 Dockerfile을 사용할 수 있습니다.

폴백 모드

서버가 Zep Cloud API에 연결할 수 없는 경우 자동으로 폴백 모드로 시작됩니다.

• 모든 API 작업이 시뮬레이션되고 성공을 반환합니다.
• Zep Cloud API에서 실제 데이터가 전송되거나 수신되지 않습니다.
• 서버는 계속 작동하므로 클라이언트 통합이 가능합니다.
• 경고 메시지는 폴백 모드를 나타내기 위해 기록됩니다.

저장소 구조

• core/ : 핵심 기능 파일
  • zep_cloud_client.py : Zep Cloud API에 대한 클라이언트 구현
  • zep_cloud_server.py : API 접근을 위한 도구를 제공하는 MCP 서버
  • run_server.py : 서버를 직접 실행하는 독립 실행형 스크립트
• scripts/ : 운영 및 테스트를 위한 유틸리티 스크립트
  • check_user_exists.py : 사용자가 존재하는지 확인하는 유틸리티
  • create_specific_user.py : 테스트 사용자를 생성하는 스크립트
  • run_server.sh / run_server.bat : 서버를 실행하기 위한 쉘 스크립트
• tests/ : 테스트 스크립트
  • test_zep_cloud_client.py : Zep Cloud 클라이언트에 대한 단위 테스트
  • test_server_initialization_fixes.py : 서버 초기화 테스트
• config/ : 설정 파일
  • .env.example : 환경 구성을 위한 템플릿
  • requirements.txt : 패키지 종속성

보안 고려 사항

• API 키 보호 : API 키를 버전 제어에 커밋하지 마세요
• 환경 변수 : 민감한 데이터에 환경 변수를 사용하세요
• 제한된 액세스 : 서버를 신뢰할 수 있는 네트워크로 제한합니다.

다른 클라이언트 지원

이 MCP 서버는 모든 MCP 호환 클라이언트와 호환되도록 설계되었습니다. 다음 클라이언트에서 테스트되었습니다.

• 클로드 데스크탑
• 웹 브라우저의 클로드

개발

테스트 실행

개발 모드에서 실행

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여되었습니다.