Joplin MCP Server

📝 조플린 MCP 서버

Joplin 용 MCP(Model Context Protocol) 서버로 , Model Context Protocol을 통해 노트에 접근할 수 있도록 지원합니다. Claude와 같은 AI 비서와의 통합에 적합합니다.

✨ 특징

• 🔍 노트 검색 : 모든 노트에 대한 전체 텍스트 검색
• 📖 노트 읽기 : 개별 노트 검색
• ✏️ 노트 편집 : 새 노트를 만들고 기존 노트를 업데이트합니다.
• 🗑️ 메모 삭제 : 메모를 휴지통으로 이동하거나 영구적으로 삭제합니다.
• 📥 마크다운 가져오기 : 마크다운 파일을 노트로 가져오기
• 🤖 AI 통합 : Claude 및 기타 MCP 지원 AI 어시스턴트와의 원활한 통합

🚀 설치

필수 조건

• Python 3.10 이상
• 웹 클리퍼 서비스가 활성화된 Joplin Desktop
• uv (Python 패키지 관리자)

지엑스피1

⚙️ 구성

조플린 API 토큰

1. Joplin Desktop 열기
2. 도구 -> 옵션 -> 웹 클리퍼로 이동하세요.
3. 웹 클리퍼 서비스 활성화
4. API 토큰을 복사하세요

프로젝트 디렉토리에 .env 파일을 만듭니다.

클로드 데스크탑 설정

1. Claude Desktop 설치
   • Claude Desktop 다운로드
   • 최신 버전을 사용하고 있는지 확인하세요(메뉴: Claude -> 업데이트 확인...)
2. MCP 서버 구성
   { "mcpServers": { "joplin": { "command": "/PATH/TO/UV/uv", "args": [ "--directory", "/PATH/TO/YOUR/PROJECT/joplin_mcp", "run", "src/mcp/joplin_mcp.py" ] } } }
   • /PATH/TO/UV/uv uv 설치의 절대 경로로 바꾸세요.
     • which uv 로 경로를 찾으세요:
     • macOS 예시: /Users/username/.local/bin/uv
     • 예시 Windows: C:\Users\username\AppData\Local\Microsoft\WindowsApps\uv.exe
   • /PATH/TO/YOUR/PROJECT/joplin_mcp 프로젝트의 절대 경로로 바꾸세요.

   중요 : Claude Desktop은 셸 환경 변수에 액세스할 수 없으므로 uv 에 대한 전체 경로가 필요합니다.

🛠️ 사용 가능한 도구

검색 노트

조플린에서 노트를 검색하세요.

매개변수:

• query (문자열): 검색 쿼리
• limit (int, 선택 사항): 최대 결과 수(기본값: 100)

get_note

ID로 특정 메모를 검색합니다.

매개변수:

• note_id (문자열): 메모의 ID

노트 생성

새로운 메모를 만듭니다.

매개변수:

• title (문자열): 메모 제목
• body (문자열, 선택 사항): 마크다운으로 작성된 메모 내용
• parent_id (문자열, 선택 사항): 상위 폴더의 ID
• is_todo (부울, 선택 사항): 이것이 할 일 항목인지 여부

업데이트_노트

기존 메모를 업데이트합니다.

매개변수:

• note_id (문자열): 업데이트할 노트의 ID
• title (문자열, 선택 사항): 새 제목
• body (문자열, 선택 사항): 새 콘텐츠
• parent_id (문자열, 선택 사항): 새 상위 폴더 ID
• is_todo (부울, 선택 사항): 새로운 할 일 상태

메모 삭제

메모를 삭제합니다.

매개변수:

• note_id (문자열): 삭제할 노트의 ID
• permanent (부울, 선택 사항): true인 경우 메모를 영구적으로 삭제합니다.

import_markdown

마크다운 파일을 새로운 노트로 가져옵니다.

매개변수:

• file_path (문자열): 마크다운 파일 경로

🧪 개발

디버그 모드

디버그 모드에서 서버를 시작하려면:

이렇게 하면 http://localhost:5173 에서 MCP 검사기가 시작되어 도구를 테스트할 수 있습니다.

📄 라이센스

MIT 라이선스 - 저작권 (c) 2025 David Weigend

👤 저자

데이비드 바이겐드

• 웹사이트: weigend.studio
• GitHub: @dweigend

🤝 기여하기

기여, 이슈, 기능 요청을 환영합니다! 이슈 페이지를 방문하세요.