Obsidian MCP 服务器

MCP（模型上下文协议）服务器使 AI 助手能够与 Obsidian 保险库进行交互，提供阅读、创建、编辑和管理笔记和标签的工具。

警告！！！

此 MCP 拥有读写权限（如果您允许）。请。在使用 obsidian-mcp 管理笔记之前，请备份您的 Obsidian 库。我建议使用 git，但任何备份方法均可。这些工具已测试，但尚未完全测试，此 MCP 正在积极开发中。

Related MCP server: Vault Cortex

特征

• 在您的保险库中阅读和搜索笔记

• 创建新的笔记和目录

• 编辑现有笔记

• 移动和删除笔记

• 管理标签（添加、删除、重命名）

• 搜索保管库内容

要求

• Node.js 20 或更高版本（可能在较低版本上可以工作，但我尚未测试过）

• 黑曜石金库

安装

手动安装

添加到您的 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"

视窗：

"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 保管库目录。配置服务器时，请确保：

• 仅提供对您预期的保险库目录的访问权限

• 在批准之前审查工具操作

故障排除

常见问题：

1. 服务器未显示在 Claude Desktop 中

   • 验证配置文件语法

   • 确保库路径是绝对路径并且存在

   • 重启Claude桌面

2. 权限错误

   • 确保保管库路径可读/可写

   • 检查保管库中的文件权限

3. 工具执行失败

   • 检查 Claude Desktop 日志：

     • macOS： ~/Library/Logs/Claude/mcp*.log

     • Windows： %APPDATA%\Claude\logs\mcp*.log

执照

麻省理工学院