OBSIDIAN-MCP-SERVER

与 LLM Agent 对接的 Model Context Protocol (MCP) Stdio 服务器。此服务器为 LLM Agent 提供了基于 Python 的 Obsidian 相关功能，使其能够利用 Obsidian 的相关功能。

功能

知识库管理

• 知识库创建
• 知识库删除
• 知识库列表查询
• 知识库信息查询
• 知识库设置查询
• 知识库设置更改

文件管理

• 知识库文件列表查询
• 知识库文件创建（新建/编辑）
• 知识库文件删除

安装方法

1. 仓库克隆

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

2. 虚拟环境创建与激活

python -m venv venv
source venv/bin/activate  # Linux/Mac 系统
# 或者
.\venv\Scripts\activate  # Windows 系统

3. 依赖项安装

pip install -r requirements.txt

4. 环境变量配置 创建 .env 文件并添加以下内容：

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

使用方法

服务器启动

python main.py

API 使用示例

知识库创建

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

知识库列表查询

{
    "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: 知识库未找到
• -32002: 知识库已存在
• -32003: 文件未找到
• -32004: 路径未找到
• -32005: 设置文件未找到
• -32006: 配置错误
• -32007: 文件操作错误
• -32008: 请求错误
• -32009: 环境变量配置错误
• -32010: Obsidian 目录错误

响应格式

成功响应

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "status": "success",
        "message": "Vault created successfully"
    }
}

失败响应

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32001,
        "message": "Vault not found"
    }
}

许可证

[此处插入许可证内容]

Cursor 安装步骤

要将此服务器与 Cursor 配合使用，请在 config.json 中添加以下配置：

{
    "mcp_server": {
        "command": "/path/to/venv/bin/python",
        "script_path": "/path/to/main.py"
    }
}

确保：

1. /path/to/venv/bin/python 是运行 MCP 服务器的 Python 可执行文件路径。
2. /path/to/main.py 是 MCP 服务器主脚本的路径。