잉크드롭 MCP 서버
Inkdrop 로컬 HTTP 서버 API를 위한 모델 컨텍스트 프로토콜 서버입니다.
설치
- 로컬 HTTP 서버 설정
- Claude Desktop에 서버 구성 추가:
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
지엑스피1
구성 요소
도구
read-note
: 데이터베이스에서 ID로 노트의 전체 내용을 검색합니다.- 필수 입력 사항:
noteId
: 검색할 노트의 ID입니다. 노트 문서에서 _id
로 확인할 수 있으며, 항상 note:
로 시작합니다.
search-notes
: 주어진 키워드를 포함하는 모든 노트를 나열합니다.- 필수 입력 사항:
- 참고: 결과에는 잘린 메모 본문(200자)이 포함됩니다. 전체 내용을 보려면
read-note
사용하세요. book:
, tag:
, status:
, title:
, 등과 같은 고급 검색 한정자를 지원합니다.
list-notes
: 지정된 조건에 맞는 모든 노트를 나열합니다.- 필수 입력 사항:
bookId
: 노트북 ID입니다. 항상 'book:'으로 시작합니다.
- 선택 입력 사항:
tagIds
: 필터링할 태그 ID 배열입니다. 각 태그는 'tag:'로 시작합니다.keyword
: 노트를 필터링할 키워드.sort
: 필드( updatedAt
, createdAt
또는 title
)를 정렬합니다. 기본값: updatedAt
.descending
: 출력 순서를 반대로 합니다. 기본값: true
.
- 참고: 결과에는 잘린 메모 본문(200자)이 포함됩니다. 전체 내용을 보려면
read-note
사용하세요.
create-note
: 데이터베이스에 새로운 노트를 생성합니다.- 필수 입력 사항:
bookId
: 노트북 ID입니다. 'book:'으로 시작하거나 'trash'여야 합니다.title
: 메모 제목.body
: 마크다운으로 쓴 노트의 내용입니다.
- 선택 입력 사항:
status
: 메모 상태( none
, active
, onHold
, completed
, dropped
).
update-note
: 데이터베이스에 있는 기존 노트를 업데이트합니다.- 필수 입력 사항:
_id
: 메모 ID입니다. 'note:'로 시작해야 합니다._rev
: 개정 ID(CouchDB MVCC-토큰)입니다.bookId
: 노트북 ID입니다. 'book:'으로 시작하거나 'trash'여야 합니다.title
: 메모 제목.body
: 마크다운으로 쓴 노트의 내용입니다.
- 선택 입력 사항:
status
: 메모 상태( none
, active
, onHold
, completed
, dropped
).
list-notebooks
: 모든 노트북 목록을 검색합니다.list-tags
: 모든 태그 목록을 검색합니다.
디버깅
MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.
다음 명령을 사용하여 npm
통해 MCP Inspector를 시작할 수 있습니다.
npx @modelcontextprotocol/inspector "./dist/index.js"
환경 변수가 올바르게 구성되었는지 확인하세요.
Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.
다음 명령을 사용하여 서버 로그를 볼 수도 있습니다.
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-inkdrop.log