Obsidian MCP 服务器

一个支持 AI 助手与 Obsidian 知识库交互的 MCP (模型上下文协议) 服务器，提供阅读、创建、编辑和管理笔记与标签的工具。

警告！！！

本 MCP 具有读写权限（如果您允许）。请在使用 obsidian-mcp 管理笔记前务必备份您的 Obsidian 知识库。推荐使用 git，但任何备份方式都可行。这些工具经过测试但不够彻底，且本项目正在积极开发中。

功能

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

系统要求

• 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 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

开发

# 克隆仓库
git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp

# 安装依赖
npm install

# 构建
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 知识库目录。配置时请确保：

• 仅授权访问目标知识库目录
• 执行工具操作前进行审查

故障排除

常见问题：

1. 服务器未出现在 Claude Desktop 中

   • 验证配置文件语法
   • 确认知识库路径为绝对路径且存在
   • 重启 Claude Desktop

2. 权限错误

   • 确保知识库路径可读/可写
   • 检查知识库文件权限

3. 工具执行失败

   • 查看 Claude Desktop 日志：
     • macOS: ~/Library/Logs/Claude/mcp*.log
     • Windows: %APPDATA%\Claude\logs\mcp*.log

许可证

MIT