Obsidian MCP(모델 컨텍스트 프로토콜)

Obsidian MCP는 모델 컨텍스트 프로토콜(MCP)을 사용하여 Obsidian 볼트와 상호작용할 수 있는 도구입니다. 이를 통해 AI 비서가 표준화된 인터페이스를 통해 Obsidian 볼트의 메모를 읽고, 쓰고, 조작할 수 있습니다.

필수 조건

• Node.js 18 이상

• 로컬 REST API 플러그인이 설치 및 구성된 Obsidian

• 로컬 REST API 플러그인에서 생성된 API 키

Related MCP server: MCP Obsidian

MCP 서버 설정(예: Claude Desktop App)

1. 이 저장소를 복제하세요

2. 종속성 설치:

   지엑스피1

3. 프로젝트를 빌드하세요:

   npm run build

4. 이 MCP 서버를 사용하도록 Claude Desktop App을 구성하세요.

   {
      "mcpServers": {
        "Obsidian": {
          "command": "node",
          "args": ["/Users/<Your Own Path>/obsisian-mcp/build/index.js"],
          "env": {
            "apiKey": "<Your API Token>",
            "port": "27123",
            "host": "127.0.0.1"
          }
        }
      }
    }

개발

위에서 언급한 대로 .env 생성하고 "apiKey", "port", "host"를 구성합니다.

사용 가능한 도구

다음 도구가 구현되었습니다.

1. readNote - 특정 노트의 내용을 읽습니다.

   {
     "path": "path/to/note.md"
   }

2. readActiveNote - 현재 활성 노트의 내용을 읽습니다.

   {}

3. listNotes - 전체 Vault 또는 지정된 폴더 아래의 파일과 폴더를 재귀적으로 나열합니다.

   {
     "path": "optional/folder/path"
   }

4. patchNote - 제목, 블록 참조 또는 프런트매터 필드를 기준으로 기존 노트에 콘텐츠를 삽입합니다.

   {
     "path": "path/to/note.md",
     "operation": "append|prepend|replace",
     "targetType": "heading|block|frontmatter",
     "target": "target_identifier",
     "content": "content to insert"
   }

5. searchWithJsonLogic - JsonLogic 형식 쿼리를 사용하여 Obsidian 노트 검색

   {
     "query": {
       // JsonLogic query object
     }
   }