메모리 MCP

저수준 서버 구현과 SQLite 저장소를 사용하여 메모리를 저장하고 검색하기 위한 모델 컨텍스트 프로토콜 서버입니다.

설치

이 프로젝트에서는 pip 대신 uv를 사용하여 종속성을 관리합니다. uv는 빠르고 안정적인 Python 패키지 설치 및 확인 프로그램입니다.

uv를 사용하여 설치:

지엑스피1

또는 소스에서 직접 설치:

개발을 위해:

uv가 설치되어 있지 않다면 공식 지침 에 따라 설치할 수 있습니다.

용법

서버 실행

이렇게 하면 메모리를 저장하고 검색할 수 있는 MCP 서버가 시작됩니다.

사용 가능한 도구

메모리 MCP는 다음과 같은 도구를 제공합니다.

• remember : 제목과 내용을 넣어 새로운 기억을 저장하다
• get_memory : ID 또는 제목으로 특정 메모리를 검색합니다.
• list_memories : 저장된 모든 메모리를 나열합니다
• update_memory : 기존 메모리 업데이트
• delete_memory : 메모리 삭제

MCP Inspect를 사용한 디버깅

MCP는 mcp inspect 라는 편리한 명령줄 도구를 제공하는데, 이를 통해 MCP 서버와 직접 디버깅하고 상호작용할 수 있습니다.

설정

1. 먼저 MCP CLI 도구가 설치되어 있는지 확인하세요.

2. 한 터미널에서 메모리 MCP 서버를 시작합니다.

3. 다른 터미널에서 mcp inspect 사용하여 실행 중인 서버에 연결합니다.

MCP Inspect 사용

연결되면 다음을 수행할 수 있습니다.

사용 가능한 도구 나열

이렇게 하면 메모리 MCP 서버에서 제공하는 모든 도구가 표시됩니다.

도구 호출

도구를 호출하려면 call 명령 다음에 도구 이름과 필요한 인수를 사용합니다.

디버그 모드

디버그 모드를 활성화하면 자세한 요청 및 응답 정보를 볼 수 있습니다.

이를 통해 서버로 어떤 데이터가 전송되고, 서버에서 어떤 데이터가 수신되는지 정확히 파악할 수 있습니다.

도구 스키마 탐색

특정 도구에 대한 스키마를 보려면:

여기에는 도구에 대한 입력 스키마, 필수 매개변수 및 설명이 표시됩니다.

문제 해결

문제가 발생하는 경우:

1. 서버가 실행 중인 터미널의 서버 로그를 확인하여 오류 메시지가 있는지 확인하세요.
2. MCP 검사 터미널에서 디버그 모드를 활성화하고 debug on 원시 요청과 응답을 확인하세요.
3. 도구 매개변수가 예상 스키마와 일치하는지 확인합니다( tool 명령으로 확인).
4. 서버가 충돌하는 경우 서버 터미널에서 처리되지 않은 예외가 있는지 확인하세요.

개발

프로젝트에 기여하려면 개발 종속성을 설치하세요.

종속성 관리

이 프로젝트에서는 uv.lock 파일을 사용하여 종속성을 잠급니다. 종속성을 업데이트하려면 다음을 수행하세요.

테스트 실행

코드 포맷팅

린팅

유형 검사