Obsidian MCP Server

Obsidian 통합을 위한 모델 컨텍스트 프로토콜 서버

이는 Obsidian과의 통합을 구현하는 TypeScript 기반 MCP 서버입니다. 다음을 제공하여 핵심 MCP 개념을 보여줍니다.

• 흑요석 보관소 콘텐츠를 나타내는 리소스

• 볼트 데이터 액세스를 위한 도구

• Obsidian과 API 통합

프로젝트 통계

• 총 코드 줄 수: 345

• 주요 파일:

  • src/tool-handlers.ts (76줄)

  • src/resource-handlers.ts (45줄)

  • src/server.ts (32줄)

  • src/api-client.ts (25줄)

Related MCP server: MCP Server

디렉토리 구조

지엑스피1

특징

자원

• obsidian://server-info URI를 통해 Obsidian 서버 정보에 액세스하세요.

• 메타데이터를 사용하여 볼트 콘텐츠 가져오기

• 간편한 통합을 위한 JSON 형식

도구

• get_vault_contents - Obsidian 볼트의 내용을 검색합니다.

  • 경로를 선택적 매개변수로 사용합니다(기본값: 루트 디렉토리)

  • 구조화된 JSON 응답을 반환합니다.

API 통합

• Obsidian API를 통한 안전한 HTTPS 연결

• 오류 처리 기능이 있는 사용자 정의 Axios 클라이언트

• Windows 경로 정규화 지원

개발

필수 조건

• Node.js v18+

• 타입스크립트 5.3+

• Obsidian API 키(OBSIDIAN_API_KEY 환경 변수로 설정됨)

설정

# Install dependencies
npm install

# Build the server
npm run build

# Start development server with auto-rebuild
npm run watch

설치

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "/path/to/obsidian-mcp/build/index.js",
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

디버깅

MCP Inspector를 사용하는 것이 좋습니다.

npm run inspector

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

종속성

실행 시간

• @modelcontextprotocol/sdk: MCP 서버 구현

• axios: API 통신을 위한 HTTP 클라이언트

개발

• @types/node: Node.js에 대한 TypeScript 정의

• 타입스크립트: 타입스크립트 컴파일러