Obsidian MCP Server

Obsidian MCP Server

一个简单的用于黑曜石的MCP服务器。

GitHub
Created ByStevenStavrakisStevenStavrakis

Obsidian MCP 是一个 Model Context Protocol 服务器，让 AI 助手能够与您的 Obsidian 笔记库交互。

⚠️ 警告：此 MCP 具有读写权限。使用前请备份您的 Obsidian 仓库！

主要功能

  • 读取、搜索、创建和编辑笔记
  • 管理笔记目录结构
  • 处理标签（添加、删除、重命名）

设置步骤

1. 前置需求

  • Node.js 20+
  • Obsidian 仓库

2. 安装和配置

编辑 Claude Desktop 配置文件：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
    "mcpServers": {
        "obsidian": {
            "command": "npx",
            "args": ["-y", "obsidian-mcp", "/path/to/your/vault"]
        }
    }
}

将 /path/to/your/vault 替换为您 Obsidian 仓库的绝对路径。

3. 使用方法

配置后重启 Claude Desktop，锤子图标表示服务器已连接。现在可以使用以下工具：

  • read-note - 读取笔记内容
  • create-note - 创建新笔记
  • edit-note - 编辑现有笔记
  • search-vault - 搜索仓库
  • add-tags/remove-tags/rename-tag - 管理标签
  • 更多工具：delete-note、move-note、create-directory等

故障排除

如果遇到问题，请检查日志：

  • macOS: ~/Library/Logs/Claude/mcp*.log
  • Windows: %APPDATA%\Claude\logs\mcp*.log

常见问题：

  1. 服务器未连接 - 检查配置文件语法和路径
  2. 权限错误 - 确认仓库路径可读/可写
  3. 工具执行失败 - 查看日志获取详细信息

开发者信息

如需从源代码构建：

git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp
npm install
npm run build

详细文档请参见 docs 目录。