Obsidian MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides access to Obsidian vault contents, allowing retrieval of vault files and metadata through the 'get_vault_contents' tool. Connects to the Obsidian API to retrieve information about the vault structure and file contents.

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줄)

디렉토리 구조

지엑스피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 정의
  • 타입스크립트: 타입스크립트 컴파일러

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

TypeScript 기반 MCP 서버를 사용하면 사용자는 텍스트 노트를 관리하고 요약할 수 있으며 노트 생성 및 요약 프롬프트를 위한 도구를 제공합니다.

  1. Directory Structure
    1. Features
      1. Resources
      2. Tools
      3. API Integration
    2. Development
      1. Prerequisites
      2. Setup
    3. Installation
      1. Debugging
        1. Dependencies
          1. Runtime
          2. Development
        ID: 02n7aazeu1