obsidian-mcp-server

3.2

If you are the rightful owner of obsidian-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

OBSIDIAN-MCP-SERVER is a Model Context Protocol (MCP) Stdio server that integrates with LLM Agents to provide Python-based Obsidian functionalities.

OBSIDIAN-MCP-SERVER

LLM Agent와 연동 가능한 Model Context Protocol (MCP) Stdio 서버입니다. 이 서버는 LLM Agent가 Obsidian 관련 기능을 활용할 수 있도록 Python 기반의 Obsidian 관련 기능들을 제공합니다.

기능

Vault 관리

Vault 생성
Vault 삭제
Vault 목록 조회
Vault 정보 조회
Vault 설정 조회
Vault 설정 변경

파일 관리

Vault 파일 목록 조회
Vault 파일 작성(생성/수정)
Vault 파일 삭제

설치 방법

저장소 클론

git clone https://github.com/your-username/obsidian-mcp-server.git
cd obsidian-mcp-server

가상 환경 생성 및 활성화

python -m venv venv
source venv/bin/activate  # Linux/Mac
# 또는
.\venv\Scripts\activate  # Windows

의존성 설치

pip install -r requirements.txt

환경 변수 설정 .env 파일을 생성하고 다음 내용을 추가합니다:

OBSIDIAN_VAULT_PATH=/path/to/your/obsidian/vault

사용 방법

서버 실행

python main.py

API 사용 예시

Vault 생성

{
    "jsonrpc": "2.0",
    "method": "create_vault",
    "params": {
        "vault_name": "my_vault",
        "path": "/optional/custom/path"
    },
    "id": 1
}

Vault 목록 조회

{
    "jsonrpc": "2.0",
    "method": "list_vaults",
    "params": {},
    "id": 2
}

파일 작성

{
    "jsonrpc": "2.0",
    "method": "write_vault_file",
    "params": {
        "vault_name": "my_vault",
        "file_path": "notes/example.md",
        "content": "# Example Note\n\nThis is a test note."
    },
    "id": 3
}

에러 코드

-32000: 일반 오류
-32001: Vault를 찾을 수 없음
-32002: Vault가 이미 존재함
-32003: 파일을 찾을 수 없음
-32004: 경로를 찾을 수 없음
-32005: 설정 파일을 찾을 수 없음
-32006: 잘못된 설정
-32007: 파일 작업 오류
-32008: 잘못된 요청
-32009: 환경 변수 설정 오류
-32010: Obsidian 디렉토리 오류

응답 형식

성공 응답

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "status": "success",
        "message": "Operation completed successfully",
        "data": {}
    }
}

오류 응답

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32001,
        "message": "Vault 'my_vault' does not exist"
    }
}

라이선스

MIT License

Cursor 설치 방법

Cursor에서 이 MCP 서버를 사용하려면 다음과 같이 설정하세요:

"obsidian-mcp-server": {
    "transport": "stdio",
    "command": "/path/to/your/venv/bin/python",
    "args": ["/path/to/your/obsidian-mcp-server/main.py"],
    "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
    }
}

각 경로를 자신의 환경에 맞게 수정하세요:

/path/to/your/venv/bin/python: Python 가상환경의 Python 실행 파일 경로
/path/to/your/obsidian-mcp-server/main.py: 이 프로젝트의 main.py 파일 경로
/path/to/your/obsidian/vault: Obsidian Vault 경로

Related MCP Servers

View all file_systems servers →

markdownify-mcp

4.6

by zcaceres

Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format.

obsidian-mcp-server

OBSIDIAN-MCP-SERVER

기능

Vault 관리

파일 관리

설치 방법

사용 방법

서버 실행

API 사용 예시

Vault 생성

Vault 목록 조회

파일 작성

에러 코드

응답 형식

성공 응답

오류 응답

라이선스

Cursor 설치 방법

Related MCP Servers

markdownify-mcp

Office-Word-MCP-Server

mcp-obsidian

mcp-obsidian

mcp-filesystem-server

obsidian-mcp

mcp-claude-code

moling

obsidian-mcp-tools

claude-code-mcp

notion_mcp

obsidian-mcp-server

python-mcp-server-client

UnityMCPIntegration

mcp-ui

cursor-mcp-file-organizer

obsidian-mcp

mcp-excel-server

aws-sa-tools-mcp-server

mcp-server-multiverse

gdrive-mcp-server

OpenSCAD-MCP-Server

notion-mcp-light

mcp-filesystem

paperless-mcp

mcp-pdf-tools

file_analysis_mcp