MCP 옵시디언

Obsidian Vault 통합을 위한 모델 컨텍스트 프로토콜 서버입니다. Claude Desktop(또는 모든 MCP 클라이언트)에서 Obsidian 메모를 검색하고 읽을 수 있습니다.

빠른 시작(사용자용)

필수 조건

• Node.js 18+ ( brew install node 통해 설치)

• 흑요석 금고

• Claude Desktop( https://claude.ai/desktop 에서 설치)

구성

1. ~/Library/Application Support/Claude/claude_desktop_config.json 에서 Claude Desktop 구성 파일을 엽니다.

Claude Desktop 메뉴를 통해 이 기능을 찾을 수 있습니다.

1. 클로드 데스크톱 열기

2. Mac 메뉴 막대에서 Claude를 클릭하세요

3. "설정"을 클릭하세요

4. "개발자"를 클릭하세요

5. 구성에 다음을 추가하세요.

지엑스피1

참고: /path/to/your/obsidian/vault 실제 Obsidian 볼트 경로로 바꾸세요.

Related MCP server: MCP Tools for Obsidian

개발자를 위한

필수 조건

• Node.js 18+ ( brew install node 통해 설치)

• 흑요석 금고

• Claude Desktop( https://claude.ai/desktop 에서 설치)

• tsx ( npm install -g tsx 를 통해 설치)

설치

git clone https://github.com/kazuph/mcp-obsidian.git
cd mcp-obsidian
npm install
npm run build

구성

1. Claude Desktop이 설치되어 실행 중인지 확인하세요.

2. 아직 설치하지 않았다면 tsx를 전역적으로 설치하세요.

npm install -g tsx
# or
pnpm add -g tsx

3. ~/Library/Application Support/Claude/claude_desktop_config.json 에 있는 Claude Desktop 구성을 수정하세요.

Claude Desktop 메뉴를 통해 쉽게 찾을 수 있습니다.

1. 클로드 데스크톱 열기

2. Mac 메뉴 막대에서 Claude를 클릭하세요

3. "설정"을 클릭하세요

4. "개발자"를 클릭하세요

MCP 클라이언트 구성에 다음을 추가하세요.

{
  "tools": {
    "obsidian": {
      "args": ["tsx", "/path/to/mcp-obsidian/index.ts"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

사용 가능한 도구

• obsidian_read_notes : 여러 노트의 내용을 읽습니다. 각 노트의 내용은 참조 경로와 함께 반환됩니다.

• obsidian_search_notes : 이름으로 노트를 검색합니다(대소문자 구분 없음, 부분 일치 및 정규 표현식 지원).

• obsidian_read_notes_dir : 지정된 경로 아래의 디렉토리 구조를 나열합니다.

• obsidian_write_note : 지정된 경로에 새로운 노트를 만듭니다.