Obsidian MCP 配置教程

本文记录如何配置 Obsidian MCP Server，让 AI 助手（如 Kiro、Claude Desktop）直接读写你的 Obsidian 笔记。

前置条件

1. 安装 Obsidian
2. 安装 Node.js（推荐 v18+）
3. 安装 Obsidian 插件：Local REST API

配置 Local REST API 插件

1. 打开 Obsidian → 设置 → 第三方插件 → 浏览社区插件
2. 搜索 Local REST API 并安装启用
3. 在插件设置中：
   • 启用 HTTPS（默认端口 27124）
   • 复制生成的 API Key

MCP 配置

在 .kiro/settings/mcp.json（或对应 MCP 客户端配置文件）中添加：

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp-server"],
      "env": {
        "OBSIDIAN_API_KEY": "你的API密钥",
        "OBSIDIAN_BASE_URL": "https://127.0.0.1:27124",
        "OBSIDIAN_VERIFY_SSL": "false"
      }
    }
  }
}

如果使用 nvm，需要用完整路径：/Users/xxx/.nvm/versions/node/v22.16.0/bin/npx

环境变量说明

可用工具

配置成功后，AI 可以使用以下工具：

• obsidian_list_notes - 列出笔记和目录
• obsidian_read_note - 读取笔记内容
• obsidian_update_note - 创建/更新笔记（append/prepend/overwrite）
• obsidian_delete_note - 删除笔记
• obsidian_global_search - 全局搜索
• obsidian_search_replace - 搜索替换
• obsidian_manage_frontmatter - 管理 YAML 元数据
• obsidian_manage_tags - 管理标签

测试连接

配置完成后，重新连接 MCP 服务器，然后让 AI 执行：

• “列出我的笔记”
• “读取 xxx.md 的内容”

参考

• GitHub: cyanheads/obsidian-mcp-server
• npm: obsidian-mcp-server