Repolode
제출하기
MarkusPfundstein

MarkusPfundstein/mcp-obsidian

Local REST API 플러그인을 통해 AI 어시스턴트가 Obsidian 보관함의 노트를 읽고, 검색하고, 추가하거나 삭제할 수 있게 해주는 MCP 서버입니다.

GitHub에서 보기
스타
4,521
포크
508
열린 이슈
107
마지막 커밋
2개월 전

어떤 프로젝트인가요?

mcp-obsidian은 Claude Desktop 같은 AI 클라이언트를 Obsidian 보관함에 연결하는 Model Context Protocol(MCP) 서버입니다. Obsidian의 커뮤니티 플러그인인 Local REST API를 통해 작동하므로, 해당 플러그인을 활성화하고 API 키를 설정한 상태로 Obsidian을 실행해야 합니다.

연결이 완료되면 어시스턴트는 보관함의 파일과 폴더 목록을 확인하고, 노트 내용을 읽고, 전체 파일에서 텍스트를 검색할 수 있습니다. 또한 제목, 블록 참조 또는 frontmatter 필드를 기준으로 콘텐츠를 삽입하거나, 새 파일 또는 기존 파일에 콘텐츠를 추가하고, 파일이나 디렉터리를 삭제할 수 있습니다. 설정에는 API 키와 선택 사항인 호스트 및 포트가 사용되며, 기본값은 각각 127.0.0.1과 27124입니다.

이 프로젝트는 uvx, 로컬 uv 환경 또는 host.docker.internal을 통해 호스트에 연결하는 Docker 컨테이너에서 실행할 수 있습니다. Python 3.11 이상과 2.0 미만 버전의 mcp Python SDK가 필요합니다.

핵심 기능

  • 01보관함 루트 또는 지정한 폴더의 파일과 디렉터리 목록을 표시합니다.
  • 02단일 노트의 전체 내용을 읽습니다.
  • 03보관함의 모든 파일에서 텍스트를 검색합니다.
  • 04제목, 블록 참조 또는 frontmatter 필드를 기준으로 노트에 콘텐츠를 삽입합니다.
  • 05새 파일이나 기존 파일에 콘텐츠를 추가하고 파일 또는 디렉터리를 삭제합니다.

활용 사례

  • AI 어시스턴트에게 Obsidian에 저장된 노트를 요약하거나 설명해 달라고 요청합니다.
  • 보관함에서 특정 주제가 언급된 곳을 모두 검색하고 주변 맥락을 확인합니다.
  • 기존 노트를 바탕으로 새로운 회의 요약 노트를 자동으로 생성합니다.
  • AI 어시스턴트가 개인 지식 베이스의 노트를 관리하고 업데이트하도록 합니다.

빠른 시작

  1. 1

    Obsidian Local REST API 커뮤니티 플러그인을 설치하고 활성화한 다음 API 키를 복사합니다

  2. 2

    OBSIDIAN_API_KEY, OBSIDIAN_HOST, OBSIDIAN_PORT를 설정해 MCP 클라이언트 구성에 서버를 추가합니다

  3. 3

    uvx로 게시된 서버를 실행합니다

    uvx mcp-obsidian

사용 전 알아둘 점

  • Obsidian Local REST API 커뮤니티 플러그인을 설치하고 Obsidian에서 실행해야 합니다.
  • Python 3.11 이상이 필요하며 mcp 의존성은 2.0 미만 버전이어야 합니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱MCP 서버

토픽

#mcp#obsidian#notes#knowledge-management#llm#python#ai-agent

자주 묻는 질문

mcp-obsidian은(는) 무엇인가요?
Local REST API 플러그인을 통해 AI 어시스턴트가 Obsidian 보관함의 노트를 읽고, 검색하고, 추가하거나 삭제할 수 있게 해주는 MCP 서버입니다. mcp-obsidian은 Claude Desktop 같은 AI 클라이언트를 Obsidian 보관함에 연결하는 Model Context Protocol(MCP) 서버입니다. Obsidian의 커뮤니티 플러그인인 Local REST API를 통해 작동하므로, 해당 플러그인을 활성화하고 API 키를 설정한 상태로 Obsidian을 실행해야 합니다.
mcp-obsidian은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mcp-obsidian은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mcp-obsidian은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. mcp-obsidian의 마지막 커밋은 2026년 8월 31일입니다.
mcp-obsidian은(는) 어디에 사용할 수 있나요?
AI 어시스턴트에게 Obsidian에 저장된 노트를 요약하거나 설명해 달라고 요청합니다. 보관함에서 특정 주제가 언급된 곳을 모두 검색하고 주변 맥락을 확인합니다. 기존 노트를 바탕으로 새로운 회의 요약 노트를 자동으로 생성합니다. AI 어시스턴트가 개인 지식 베이스의 노트를 관리하고 업데이트하도록 합니다.
mcp-obsidian는 어떻게 설치하나요?
Obsidian Local REST API 커뮤니티 플러그인을 설치하고 활성화한 다음 API 키를 복사합니다 OBSIDIAN_API_KEY, OBSIDIAN_HOST, OBSIDIAN_PORT를 설정해 MCP 클라이언트 구성에 서버를 추가합니다 uvx로 게시된 서버를 실행합니다: uvx mcp-obsidian
mcp-obsidian은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/MarkusPfundstein/mcp-obsidian

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트