Obsidian MCP Server 配置与使用说明

支持客户端

• Claude Desktop
• Cursor

安装命令

npx -y mcp-obsidian /path/to/vault

配置示例

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian",
        "/Users/you/ObsidianVault"
      ]
    }
  }
}

权限范围与安全提示

可读写指定 Obsidian 笔记库中的文件

• file-read
• file-write

风险评分：3/10

常见报错

Vault 路径不存在

确认路径指向有效的 Obsidian Vault 目录

文件编码错误

确认笔记文件为 UTF-8 编码

来源

• 官方文档 / 仓库

最近核验：2026-05-18。客户端版本和配置格式可能变化，使用前请以官方文档为准。

相关工具