Obsidian Index MCP 서버

Obsidian 볼트에 대한 의미 검색을 제공하고 최근 메모를 리소스로 표시하는 MCP 서버입니다.

구성 요소

자원

서버는 최근 수정된 보관소의 메모를 MCP 클라이언트에 리소스로 제공합니다.

• 메모는 obsidian://<VAULT_NAME>/<NOTE_PATH> URL 체계를 통해 처리됩니다.

• 노트에는 text/markdown 미디어 유형이 있습니다.

도구

서버는 하나의 도구를 구현합니다.

• search-notes : 인덱스된 노트에 대한 의미 검색을 수행합니다.

Related MCP server: @kazuph/mcp-obsidian

서버를 실행하세요

지엑스피1

• --vault : Obsidian 볼트 경로(여러 번 지정 가능)

• --database : 로컬 데이터베이스 파일에 대한 경로(존재하지 않으면 생성됩니다)

• --reindex : 보관소에 있는 모든 노트를 다시 인덱싱합니다(지금 당장도 이 기능이 필요할 것입니다)

• --watch : 볼트의 변경 사항을 감시하고 그에 따라 인덱스를 업데이트합니다.

빠른 시작

설치하다

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

1. 종속성 동기화 및 잠금 파일 업데이트:

uv sync

2. 패키지 배포 빌드:

uv build

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

3. PyPI에 게시:

uv publish

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

• 토큰: --token 또는 UV_PUBLISH_TOKEN

• 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

npx @modelcontextprotocol/inspector uv --directory <PATH_TO_PROJECT> run obsidian-index

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.