local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags within Obsidian.

Obsidian MCP 服务器

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

警告！！！

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

特征

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

要求

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

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

故障排除

常见问题：

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

执照

麻省理工学院

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

使 AI 助手能够与 Obsidian 保险库进行交互，提供阅读、创建、编辑和管理笔记和标签的工具。