Obsidian MCP Server

这是一个MCP（模型上下文协议）服务器，它使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 Desktop。您应该能看到锤子图标出现，表示服务器已连接。

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

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

通过Smithery安装

警告：我不隶属于Smithery。我没有测试过使用它，并鼓励用户如果可以的话手动安装。

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

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": ["<绝对路径到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