Obsidian MCP 서버

“Obsidian” MCP 서버는 무엇을 하나요?

Obsidian MCP 서버는 Claude Desktop 또는 Model Context Protocol(MCP) 클라이언트가 Obsidian 볼트와 같은 마크다운 노트 디렉터리를 읽고 검색할 수 있도록 해주는 커넥터입니다. 이 서버는 AI 어시스턴트와 마크다운 형식으로 저장된 개인/팀 지식 베이스 간의 다리를 놓아, 개발 워크플로 내에서 노트에 더 쉽게 접근하고, 검색하며, 활용할 수 있도록 해줍니다. Obsidian 등 외부 데이터 소스와 연동하여, AI 도구가 정보 검색, 특정 노트 조회, 내용 요약 등의 작업을 수행할 수 있게 하여, 개발자와 지식 노동자를 위한 생산성과 지식 관리를 향상시킵니다.

프롬프트 목록

문서상에 명시된 프롬프트 템플릿은 없습니다.

리소스 목록

제공된 문서에 구체적인 리소스 내용은 없습니다.

도구 목록

문서 및 제공된 이미지를 참고하면 설치 후 아래와 같은 도구가 나열됩니다(코드 설명은 없음):

• Read Note: Obsidian 볼트 내 특정 노트의 내용을 읽을 수 있습니다.
• Search Notes: 키워드 또는 쿼리를 기반으로 볼트 내 노트를 검색할 수 있습니다.

참고: 정확한 도구명과 설명은 문서 및 이미지에서 유추하였으며, 추가 세부 정보는 명시되지 않았습니다.

이 MCP 서버의 활용 사례

• 개인 지식 관리: Claude Desktop을 통해 개인 Obsidian 볼트에서 정보를 검색, 읽기, 조회할 수 있어, 노트를 LLM이 요약하거나 질문에 답하는 데 활용할 수 있습니다.
• 팀 문서 검색: 팀원이나 AI 어시스턴트가 공유 마크다운 디렉터리를 검색 가능한 리소스로 통합하여, 지식 공유와 온보딩을 개선할 수 있습니다.
• AI 맥락 지원: 노트에서 관련 정보를 LLM에게 맥락으로 제공하여, 개발 또는 연구 중 AI의 응답 정확성과 관련성을 높일 수 있습니다.
• 자동 노트 요약: Obsidian 볼트 내 긴 노트나 문서를 AI로 요약하여 수동 요약에 드는 시간을 절약할 수 있습니다.

설정 방법

Windsurf

1. Node.js와 Windsurf가 설치되어 있는지 확인하세요.
2. Windsurf 설정 파일을 여세요.
3. mcpServers 섹션에 아래 내용을 추가하세요:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. 파일을 저장하고 Windsurf를 재시작하세요.
5. MCP 서버가 실행 중이며 접근 가능한지 확인하세요.

Claude

1. Claude Desktop과 Node.js가 설치되어 있는지 확인하세요.
2. Smithery를 사용하여 Obsidian MCP를 설치하세요:

   npx @smithery/cli install mcp-obsidian --client claude
   

3. Claude Desktop을 재시작하세요.
4. Claude Desktop 인터페이스에서 Obsidian MCP 도구가 표시되는지 확인하세요.

Cursor

1. Node.js와 Cursor가 설치되어 있는지 확인하세요.
2. Cursor 설정 파일을 여세요.
3. Obsidian MCP 서버를 다음과 같이 추가하세요:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. 저장하고 Cursor를 재시작하세요.
5. Cursor의 도구 목록에서 Obsidian MCP 서버를 확인하세요.

Cline

1. Node.js와 Cline을 설치하세요.
2. Cline 설정 파일을 수정하세요.
3. Obsidian MCP 서버를 포함시키세요:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. 설정을 저장하고 Cline을 재시작하세요.
5. 인터페이스에서 Obsidian MCP가 표시되는지 확인하여 설정을 검증하세요.

API 키 보안 설정

Obsidian MCP 서버 또는 볼트에 인증이나 API 키가 필요한 경우, 환경 변수를 사용하여 보안을 강화하세요:

{
  "obsidian": {
    "command": "npx",
    "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"],
    "env": {
      "OBSIDIAN_API_KEY": "${env:OBSIDIAN_API_KEY}"
    },
    "inputs": {
      "vaultPath": "<path-to-your-vault>"
    }
  }
}

FlowHunt에서 MCP를 사용하는 방법

FlowHunt에서 MCP 통합하기

FlowHunt 워크플로에 MCP 서버를 통합하려면, 먼저 MCP 컴포넌트를 플로우에 추가하고 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭하여 설정 패널을 엽니다. 시스템 MCP 구성 섹션에 아래와 같은 JSON 포맷으로 MCP 서버 정보를 입력하세요:

{
  "obsidian": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

구성이 완료되면 AI 에이전트가 이 MCP를 도구로 활용할 수 있으며, 모든 함수와 기능에 접근할 수 있습니다. “obsidian” 부분은 실제 MCP 서버 이름으로, URL은 본인의 MCP 서버 URL로 변경하세요.

개요

위 내용을 종합하면, Obsidian MCP 서버는 Obsidian 볼트 검색 및 조회를 위한 단순하고 쉬운 설정을 제공하지만, 프롬프트 템플릿, 명시적 리소스 정의, 샘플링이나 roots와 같은 고급 MCP 기능은 부족합니다. 그럼에도 Obsidian 노트를 AI에서 활용할 수 있도록 하는 필수 도구를 제공합니다.

MCP 점수

목적의 단순성과 명확성, 설치 용이성, Obsidian 사용자를 위한 특화된 효용성을 고려할 때, 이 MCP 서버에 6/10을 점수로 부여합니다. 사용 사례에는 매우 적합하지만, 고급 MCP 기능과 문서의 깊이는 부족합니다.