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 환경 변수로 설정됨)
설정
설치
Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.
MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json
디버깅
MCP Inspector를 사용하는 것이 좋습니다.
검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.
종속성
실행 시간
- @modelcontextprotocol/sdk: MCP 서버 구현
- axios: API 통신을 위한 HTTP 클라이언트
개발
- @types/node: Node.js에 대한 TypeScript 정의
- 타입스크립트: 타입스크립트 컴파일러
You must be authenticated.
Tools
TypeScript 기반 MCP 서버를 사용하면 사용자는 텍스트 노트를 관리하고 요약할 수 있으며 노트 생성 및 요약 프롬프트를 위한 도구를 제공합니다.