Obsidian AI笔记助手

你是否曾经希望AI能够直接访问你的Obsidian笔记库，自动创建、编辑、搜索和管理笔记？今天要介绍的开源项目Obsidian AI笔记助手，正是为了实现这个目标而设计的。它是一个MCP服务器，启用AI助手与Obsidian知识库互动，提供阅读、创建、编辑和管理笔记及标签的工具。

项目基本信息

一、项目介绍

Obsidian AI笔记助手是一个让AI能够与Obsidian知识库交互的MCP工具。它提供了管理笔记和标签的完整功能，支持多知识库操作。

这个服务器提供了以下工具：

• read-note：读取笔记内容
• create-note：创建新笔记
• edit-note：编辑现有笔记
• delete-note：删除笔记
• move-note：移动笔记到不同位置
• create-directory：创建新目录
• search-vault：搜索知识库中的笔记
• add-tags：向笔记添加标签
• remove-tags：从笔记中删除标签
• rename-tag：重命名所有笔记中的标签
• manage-tags：列出和组织标签
• list-available-vaults：列出所有可用的知识库

二、核心优势

功能完整

提供12个工具，覆盖笔记和标签的完整管理。

多知识库支持

可同时管理多个Obsidian知识库。

标签管理

支持添加、删除、重命名标签。

搜索功能

在整个知识库中搜索笔记内容。

读写权限

支持读取和写入操作（谨慎使用）。

三、适用场景

笔记自动化

让AI自动整理和归类笔记。

知识库管理

AI可以创建、编辑、移动笔记。

标签系统维护

自动添加和组织标签。

笔记搜索

快速找到知识库中的特定内容。

四、安装教程

系统要求

安装步骤

第一步：配置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"]
    }
  }
}

多知识库示例：

{
  "args": ["-y", "obsidian-mcp", "/path/to/vault1", "/path/to/vault2"]
}

第二步：重启Claude Desktop

保存配置后，重启Claude Desktop。你应该会看到锤子图标出现。

第三步：通过Smithery安装（可选）

npx -y @smithery/cli install obsidian-mcp --client claude

五、使用示例

示例1：创建笔记

用户指令：“创建一个新笔记，标题为‘今日计划’，内容包含今天的任务列表”

AI会调用create-note工具。

示例2：搜索笔记

用户指令：“搜索知识库中包含‘项目计划’的笔记”

AI会调用search-vault工具。

示例3：添加标签

用户指令：“给‘今日计划’笔记添加‘工作’和‘待办’标签”

AI会调用add-tags工具。

示例4：移动笔记

用户指令：“把‘今日计划’笔记移动到‘日记’文件夹”

AI会调用move-note工具。

示例5：重命名标签

用户指令：“把所有‘todo’标签重命名为‘待办’”

AI会调用rename-tag工具。

六、重要警告

读写权限警告：此MCP具有读写权限。请在使用前备份您的Obsidian知识库。建议使用git进行版本控制。

七、常见问题

问题1：服务器未在Claude Desktop中显示

解决方案：验证配置文件语法，确保知识库路径是绝对路径且存在。

问题2：权限错误

解决方案：确保知识库路径可读/可写，检查文件权限。

问题3：Node.js版本

解决方案：需要Node.js 20或更高版本。

问题4：Windows路径格式

解决方案：使用双反斜杠C:\\Users\\...。

问题5：工具执行失败

解决方案：检查Claude Desktop日志获取详细错误。

八、总结

Obsidian AI笔记助手是一个让AI能够管理Obsidian知识库的MCP工具，提供笔记和标签的完整管理功能。

这个项目的最大价值在于：

1. 功能完整：12个工具覆盖笔记和标签管理
2. 多知识库：同时管理多个知识库
3. 标签系统：完整的标签管理
4. 搜索功能：全文搜索笔记
5. MIT许可证：可自由使用

⚠️ 重要提醒：使用前请备份您的Obsidian知识库！

如果你使用Obsidian管理笔记，并且希望用AI自动化管理，Obsidian AI笔记助手是一个非常实用的工具。