흑요석 MCP 서버

Cursor 및 Claude와 같은 AI 도우미가 Obsidian 볼트에서 읽고 쓸 수 있도록 하는 가벼운 모델 컨텍스트 프로토콜(MCP) 서버입니다.

예시 상호작용

• "오늘 내가 변경한 코드 내용을 설명하는 내일 스탠드업을 위한 새 메모를 작성하세요"(Git도 사용해야 함)

• "프로젝트 아이디어에 대한 내 메모를 확인하세요"

• "리팩토링과 관련하여 내가 해야 할 일이 무엇인지 확인하세요"

Related MCP server: MCP Tools for Obsidian

도구

읽다

1. getAllFilenames

   • Obsidian 보관소에 있는 모든 파일 이름 목록을 가져옵니다.

   • 사용 가능한 파일을 발견하는 데 유용합니다.

2. 여러 파일 읽기

   • Obsidian 보관소에서 지정된 파일의 내용을 검색합니다.

   • 정확한 파일 이름, 부분 파일 이름 또는 대소문자 구분 없이 일치를 지원합니다.

   • 각 파일의 내용은 명확한 식별을 위해 '# 파일: 파일 이름'으로 접두사가 붙습니다.

3. getOpenTodos

   • Obsidian Vault의 마크다운 파일에서 열려 있는 모든 TODO 항목을 검색합니다.

   • 선택되지 않은 체크박스 항목을 찾습니다('- [ ] '가 포함된 줄)

   • 파일 위치와 함께 반환합니다.

쓰다

1. updateFileContent

   • Obsidian 보관소의 지정된 파일의 내용을 새로운 마크다운 내용으로 업데이트합니다.

   • 파일이 존재하지 않으면 생성됩니다.

   • 필요한 디렉토리를 자동으로 생성합니다

설치 및 빌드

지엑스피1

Claude Desktop 및 Cursor와 통합

Claude Desktop과 함께 MCP 서버를 사용하려면 Claude 구성에 다음을 추가하세요.

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": [
        "obsidian-mcp-server/build/index.js",
        "/path/to/your/vault"
      ]
    }
  }
}

커서를 설정하려면 MCP 탭의 Cursor Settings (Command + Shift + J)으로 이동합니다. 다음 명령을 사용하여 서버를 추가합니다.

node obsidian-mcp-server/build/index.js /path/to/your/vault

다른 솔루션과의 비교

이 구현은 의도적으로 가볍지만 jacksteamdev/obsidian-mcp-tools 와 같은 다른 솔루션은 Obsidian 플러그인으로 더 풍부한 기능을 제공하는 접근 방식을 제공합니다.

이 독립형 서버는 Obsidian 애플리케이션을 실행하지 않고도 파일 시스템에 직접 액세스할 수 있다는 장점이 있습니다.

자원

• 모델 컨텍스트 프로토콜 문서

• MCP 서버 저장소