“Obsidian” MCP 서버란 무엇인가요?
Obsidian MCP(Model Context Protocol) 서버는 AI 어시스턴트가 Obsidian 볼트와 원활하게 상호작용할 수 있도록 해주는 도구입니다. 노트와 태그의 읽기, 생성, 편집, 관리 등 다양한 도구를 제공하여, Obsidian을 활용한 지식 관리에 의존하는 사용자의 개발 워크플로우를 향상시킵니다. 이 서버를 통해 AI 기반으로 노트 검색 및 정리, 태그 관리, 여러 볼트 내의 디렉터리 조작 등의 업무가 자동화됩니다. 본 통합을 통해 개발자와 사용자는 고도화된 AI 기반 컨텍스트 관리로 노트필기, 연구, 콘텐츠 구성 과정을 한층 효율화할 수 있습니다.
프롬프트 목록
저장소에 프롬프트 템플릿이 언급되어 있지 않습니다.
리소스 목록
저장소에 명시적인 MCP 리소스가 상세히 안내되어 있지 않습니다.
도구 목록
- read-note: 노트의 내용을 읽습니다.
- create-note: 새 노트를 생성합니다.
- edit-note: 기존 노트를 편집합니다.
- delete-note: 노트를 삭제합니다.
- move-note: 노트를 볼트 내 다른 위치로 이동합니다.
- create-directory: 볼트에 새 디렉터리를 만듭니다.
- search-vault: 볼트 내에서 노트를 검색합니다.
- add-tags: 노트에 태그를 추가합니다.
- remove-tags: 노트에서 태그를 제거합니다.
- rename-tag: 모든 노트에서 태그명을 변경합니다.
- manage-tags: 태그를 나열 및 정리합니다.
- list-available-vaults: 사용 가능한 모든 볼트 목록(멀티 볼트 환경에 유용)을 확인합니다.
이 MCP 서버의 활용 사례
- 볼트 전체 검색 및 조회: 하나 또는 여러 Obsidian 볼트에서 노트를 자동으로 검색·조회하여 연구자나 파워유저의 시간을 절약합니다.
- 프로그래밍 방식의 노트 관리: AI를 통해 노트의 생성, 편집, 삭제를 지원하여 지식 근로자, 학생 등의 워크플로우를 돕습니다.
- 태그 정리 및 대량 편집: 태그 추가, 제거, 이름 변경 과정을 간소화하여 대규모 정리 및 지식 그래프를 깔끔하게 유지할 수 있습니다.
- 디렉터리 및 멀티 볼트 처리: AI 지시로 디렉터리를 관리하거나 여러 볼트 간 전환을 지원해 복잡한 노트 구조를 가진 사용자의 생산성을 높입니다.
- 콘텐츠 정리 및 대량 작업: AI를 활용해 오래된 노트 정리, 체계적인 콘텐츠 재구성 등 대량 편집 작업을 자동화할 수 있습니다.
설치 방법
Windsurf
Windsurf에 대한 설치 안내는 제공되지 않습니다.
Claude
- 사전 준비
- Node.js 20 이상이 설치되어 있는지 확인합니다.
- Obsidian 볼트 디렉터리 경로를 확보합니다.
- 설정 파일 수정
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Obsidian MCP 서버 추가
- 아래와 같이
mcpServers오브젝트를 삽입/수정합니다.
- 아래와 같이
- 저장 및 재시작
- 파일을 저장한 뒤 Claude for Desktop을 재시작합니다.
- 설정 검증
- Claude에서 망치 아이콘 표시 여부를 확인하고, 문제가 있을 경우 로그를 검토합니다.
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2"]
}
}
}
Cursor
Cursor에 대한 설치 안내는 제공되지 않습니다.
Cline
Cline에 대한 설치 안내는 제공되지 않습니다.
API 키 보안
저장소에는 API 키 보안이나 환경 변수 사용에 대한 명시적 안내가 없습니다.
MCP를 플로우 내에서 사용하는 방법
FlowHunt에서 MCP 사용하기
MCP 서버를 FlowHunt 워크플로우에 통합하려면 MCP 컴포넌트를 플로우에 추가하고 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭하여 설정 패널을 엽니다. 시스템 MCP 설정 섹션에 다음과 같은 JSON 형식으로 MCP 서버 정보를 입력하세요:
{
"MCP-name": {
"transport": "streamable_http",
"url": "https://yourmcpserver.example/pathtothemcp/url"
}
}
설정이 완료되면 AI 에이전트가 이 MCP의 모든 기능과 도구를 사용할 수 있습니다. “MCP-name"은 실제 MCP 서버 이름(예: “github-mcp”, “weather-api” 등)으로 변경하고, URL도 본인의 MCP 서버 주소로 교체하세요.
개요
| 섹션 | 제공 여부 | 상세/비고 |
|---|---|---|
| 개요 | ✅ | README에서 Obsidian MCP 개요 제공 |
| 프롬프트 목록 | ⛔ | 프롬프트 템플릿 미제공 |
| 리소스 목록 | ⛔ | 명시적인 MCP 리소스 설명 없음 |
| 도구 목록 | ✅ | README에 상세 도구 목록 명시 |
| API 키 보안 | ⛔ | API 키 보안 관련 안내 및 예제 없음 |
| 샘플링 지원(평가에 중요도 낮음) | ⛔ | 언급 없음 |
저희의 의견:
Obsidian MCP 서버는 기본적인 기능을 충실히 제공하며, (Claude용) 설치 문서, 노트 및 태그 관리에 강력한 도구 세트, 명확한 MIT 라이선스를 갖추고 있습니다. 다만 프롬프트 템플릿, 리소스 원형, API 키 보안, Roots나 샘플링 등 고급 MCP 기능에 대한 명확한 정보는 제공되지 않습니다. 실용적이고 개발자 친화적이지만 MCP 프로토콜 전체 지원 면에서는 다소 아쉽습니다.
MCP 점수
| 라이선스 존재 | ✅ (MIT) |
|---|---|
| 최소 1개 도구 보유 | ✅ |
| 포크 수 | 44 |
| 별점(Stars) 수 | 401 |
평가:
두 표를 바탕으로 이 MCP는 6/10 점수를 받습니다. 실용적이고 오픈소스이며 다양한 도구를 제공하지만, 고급 MCP 기능, 프롬프트 및 리소스 템플릿, 멀티 플랫폼/설정/비밀 관리 안내는 부족합니다.
