mcpField
O
OBSIDIAN-MCP-SERVER

OBSIDIAN-MCP-SERVER

本地服务
github.com/zerogon1203记忆与知识080 周前更新
代码仓库

关于 OBSIDIAN-MCP-SERVER

OBSIDIAN-MCP-SERVER 是基于 Python 的 stdio 服务，可让大模型 Agent 管理 Obsidian Vault 和文件。它支持 Vault 配置，以及文件的创建、编辑、列表查询和删除。

主要功能

  1. 01创建和删除 Vault
  2. 02列出 Vault 并查看信息
  3. 03查看和修改 Vault 设置
  4. 04列出 Vault 文件
  5. 05创建、编辑和删除文件

适用场景

  1. 01创建或移除 Obsidian Vault
  2. 02查看或修改 Vault 设置
  3. 03通过文件操作维护笔记

MCP 相关

该 stdio MCP 服务向大模型 Agent 提供基于 Python 的 Obsidian Vault 和文件操作。

#obsidian#mcp#server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

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 파일 삭제

설치 방법

  1. 저장소 클론
git clone https://github.com/your-username/obsidian-mcp-server.git
cd obsidian-mcp-server
  1. 가상 환경 생성 및 활성화
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 또는
.\venv\Scripts\activate  # Windows
  1. 의존성 설치
pip install -r requirements.txt
  1. 환경 변수 설정 .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 경로

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。