Obsidian AI笔记助手

启用AI助手与Obsidian保险库互动，提供阅读、创建、编辑和管理笔记和标签的工具。

note-taking

912 查看 · 2026-07-07 更新

简介

启用AI助手与Obsidian保险库互动，提供阅读、创建、编辑和管理笔记和标签的工具。

简介

启用AI助手与Obsidian保险库互动，提供阅读、创建、编辑和管理笔记和标签的工具。

Obsidian MCP 服务器

这是一个 MCP (Model Context Protocol) 服务器，它使 AI 助手能够与 Obsidian 仓库进行交互，提供了读取、创建、编辑和管理笔记及标签的工具。

警告!!!

此 MCP 具有读写访问权限（如果您允许）。请务必在使用 obsidian-mcp 管理您的笔记之前备份您的 Obsidian 仓库。我推荐使用 git，但任何备份方法都可以。这些工具已经过测试，但并不全面，并且此 MCP 正在积极开发中。

功能

读取和搜索仓库中的笔记
创建新的笔记和目录
编辑现有笔记
移动和删除笔记
管理标签（添加、移除、重命名）
搜索仓库内容

要求

Node.js 20 或更高版本（可能在更低版本上也工作，但我没有测试过）
一个 Obsidian 仓库

安装

手动安装

将以下内容添加到您的 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/vault2"]
        }
    }
}

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

MacOS/Linux:

"/Users/username/Documents/MyVault"

Windows:

"C:\\Users\\username\\Documents\\MyVault"

保存配置后重新启动 Claude for Desktop。您应该会看到锤子图标出现，表示服务器已连接。

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

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

通过 Smithery 安装

警告：我与 Smithery 没有任何关联。我没有测试过使用它，并鼓励用户如果可以的话手动安装。

要通过 Smithery 自动为 Claude Desktop 安装 Obsidian：

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

开发

# Clone the repository
git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp

# Install dependencies
npm install

# Build
npm run build

然后将以下内容添加到您的 Claude Desktop 配置文件中：

{
    "mcpServers": {
        "obsidian": {
            "command": "node",
            "args": ["<absolute-path-to-obsidian-mcp>/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

可用工具

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 - 列出所有可用的仓库（有助于多仓库设置）

文档

更多文档可以在 docs 目录中找到：

creating-tools.md - 创建新工具指南
tool-examples.md - 使用可用工具的示例

安全性

此服务器需要访问您的 Obsidian 仓库目录。在配置服务器时，请确保：

仅提供对预期仓库目录的访问权限
在批准前审查工具操作

故障排除

常见问题：

服务器未在Claude桌面版中显示
- 验证您的配置文件语法
- 确保金库路径是绝对路径并且存在
- 重启Claude桌面版
权限错误
- 确保金库路径可读/可写
- 检查金库中的文件权限
工具执行失败
- 查看Claude桌面版日志：
  - macOS: ~/Library/Logs/Claude/mcp*.log
  - Windows: %APPDATA%\Claude\logs\mcp*.log

许可证

MIT

服务配置

[{'mcpServers': {'obsidian': {'args': ['-y', 'obsidian-mcp', '/path/to/your/vault', '/path/to/your/vault2'], 'command': 'npx'}}}, {'mcpServers': {'obsidian': {'args': ['<absolute-path-to-obsidian-mcp>/build/main.js', '/path/to/your/vault', '/path/to/your/vault2'], 'command': 'node'}}}]

来源

来源：github
链接：https://github.com/StevenStavrakis/obsidian-mcp