Obsidian MCP Server

基本能力

产品定位

Obsidian MCP Server 是一个为 Obsidian 知识库设计的 MCP 服务，专注于提供 AI 助手与知识库之间的高效交互能力。

核心功能

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

适用场景

• 通过 AI 助手自动化管理 Obsidian 知识库
• 批量处理笔记和标签
• 多知识库协同管理

工具列表

• 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 - 列出可用知识库

常见问题解答

1. 服务器未出现在 Claude Desktop 中
2. 检查配置文件语法
3. 确保知识库路径存在且为绝对路径

4. 重启 Claude Desktop

5. 权限错误

6. 确保知识库路径可读写

7. 检查文件权限

8. 工具执行失败

9. 检查日志文件

使用教程

使用依赖

• Node.js 20 或更高版本
• Obsidian 知识库

安装教程

手动安装

1. 编辑 Claude Desktop 配置文件：
2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

3. Windows: %APPDATA%\Claude\claude_desktop_config.json

4. 添加配置：

{
    "mcpServers": {
        "obsidian": {
            "command": "npx",
            "args": ["-y", "obsidian-mcp", "/path/to/your/vault"]
        }
    }
}

1. 重启 Claude Desktop

通过 Smithery 安装

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

调试方式

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。