MCP Notes 서버

이는 주어진 디렉터리의 마크다운 노트를 관리하는 MCP(Model Context Protocol) 서버 구현입니다. 이 서버는 stdio 전송을 사용하여 마크다운 노트를 생성, 읽기 및 업데이트하는 기능을 제공합니다.

특징

• 새로운 마크다운 노트 만들기
• 기존 마크다운 노트 읽기
• 기존 마크다운 노트 업데이트
• 보관소에 있는 모든 메모를 나열합니다
• 지정된 디렉토리의 자동 파일 관리
• 적절한 오류 처리 및 로깅
• 노트 생성 및 수정을 위한 타임스탬프 추적
• 모든 작업에 대한 JSON 스키마 검증

서버 기능

서버는 다음과 같은 기능을 구현합니다.

• 버전: 1.0.0
• 이름: Notes MCP 서버
• 설명: 주어진 디렉토리의 마크다운 노트를 관리하기 위한 서버
• 지원되는 전송: stdio

자원

서버는 다음과 같은 리소스를 제공합니다.

• 속성:
  • path : 보관소로 가는 경로
  • note_count : 보관소에 있는 노트의 총 개수

도구

서버는 다음 MCP 도구를 구현합니다.

노트 생성

새로운 마크다운 노트를 만듭니다.

매개변수:

• title : 메모의 제목 (필수)
• content : 메모의 내용(선택 사항, 기본값은 빈 문자열)

보고:

• filename : 생성된 파일의 이름
• path : 생성된 파일의 전체 경로
• created_at : 생성 ISO 타임스탬프

읽기_노트

기존의 마크다운 노트를 읽습니다.

매개변수:

• title : 읽을 노트의 제목 (필수)

보고:

• title : 노트의 제목
• content : 메모의 내용
• path : 파일의 전체 경로
• created_at : 생성 ISO 타임스탬프
• modified_at : 마지막 수정의 ISO 타임스탬프

업데이트_노트

기존 마크다운 노트를 업데이트합니다.

매개변수:

• title : 업데이트할 메모의 제목(필수)
• content : 메모의 새 내용(선택 사항, 기본값은 빈 문자열)

보고:

• filename : 업데이트된 파일의 이름
• path : 파일의 전체 경로
• updated_at : 업데이트의 ISO 타임스탬프

리스트노트

보관소에 있는 모든 마크다운 노트를 나열합니다.

매개변수: 없음

보고:

• notes : 각 노트 객체의 배열, 포함 내용:
  • title : 노트의 제목
  • path : 파일의 전체 경로
  • created_at : 생성 ISO 타임스탬프
  • modified_at : 마지막 수정의 ISO 타임스탬프
• total : 총 노트 수

설정

1. 필요한 종속성을 설치하세요:

지엑스피1

2. main.py의 110번째 줄에서 notes_dir 속성을 편집하여 서버가 주어진 디렉토리 내에서 작동하도록 구성합니다.
3. MCP 서버를 사용하도록 커서를 구성합니다.
   • 구성 파일은 .cursor/mcp.json 에 있습니다.
   • 커서는 이 구성을 자동으로 감지하고 사용합니다.
   • 서버는 Python과 적절한 UTF-8 인코딩을 사용하여 실행되도록 구성되었습니다.

서버 실행

Cursor가 프로젝트를 로드하면 서버가 자동으로 시작됩니다. 수동으로 실행할 수도 있습니다.

서버가 시작되고 stdin/stdout을 통해 MCP 요청을 수신합니다. 모든 작업은 디버깅 및 모니터링을 위해 적절한 수준(info/error)으로 기록됩니다.

오류 처리

서버는 다양한 시나리오에 대해 적절한 오류 처리를 구현합니다.

• 필수 매개변수가 없습니다
• 파일이 이미 존재합니다
• 파일을 찾을 수 없습니다
• 일반적인 예외

모든 오류는 기록되어 적절한 오류 코드와 메시지와 함께 반환됩니다.

구성 세부 정보

MCP 서버는 다음 설정으로 .cursor/mcp.json 에 구성됩니다.

MCP를 글로벌하게 사용하려면 사용자 디렉토리의 .cursor 폴더에 추가하거나 커서 설정 -> MCP -> 새 글로벌 MCP 서버 추가로 이동하여 이 프로젝트의 mcp.json을 새 파일에 복사/붙여넣기 -> 인수를 업데이트하여 main.py를 가리키도록 합니다.

이 구성:

• 서버 이름을 "notes-server"로 지정합니다.
• Python을 사용하여 서버를 실행합니다.
• 적절한 문자 처리를 위해 UTF-8 인코딩을 설정합니다.