MCP Obsidian

用于集成 Obsidian 仓库的 Model Context Protocol 服务器。这允许 Claude Desktop（或任何 MCP 客户端）搜索和阅读您的 Obsidian 笔记。

快速开始（用户）

前提条件

• Node.js 18+（通过 brew install node 安装）
• Obsidian 仓库
• Claude Desktop（从 https://claude.ai/desktop 下载安装）

配置

1. 打开您的 Claude Desktop 配置文件：
   ~/Library/Application Support/Claude/claude_desktop_config.json

您可以通过 Claude Desktop 菜单找到该文件：

1. 打开 Claude Desktop

2. 点击 Mac 菜单栏上的 Claude

3. 点击“设置”

4. 点击“开发者”

5. 在您的配置中添加以下内容：

{
  "tools": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-obsidian"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

注意：请将 /path/to/your/obsidian/vault 替换为您实际的 Obsidian 仓库路径。

开发者指南

前提条件

• Node.js 18+（通过 brew install node 安装）
• Obsidian 仓库
• Claude Desktop（从 https://claude.ai/desktop 下载安装）
• tsx（通过 npm install -g tsx 安装）

安装

git clone https://github.com/kazuph/mcp-obsidian.git
cd mcp-obsidian
npm install
npm run build

配置

1. 确保 Claude Desktop 已安装并正在运行。

2. 如果您还没有全局安装 tsx，请执行以下命令：

npm install -g tsx
# or
pnpm add -g tsx

1. 修改位于以下位置的 Claude Desktop 配置文件：
   ~/Library/Application Support/Claude/claude_desktop_config.json

您可以通过 Claude Desktop 菜单轻松找到该文件：

1. 打开 Claude Desktop
2. 点击 Mac 菜单栏上的 Claude
3. 点击“设置”
4. 点击“开发者”

在您的 MCP 客户端配置中添加以下内容：

{
  "tools": {
    "obsidian": {
      "args": ["tsx", "/path/to/mcp-obsidian/index.ts"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

可用工具

• obsidian_read_notes: 读取多篇笔记的内容。每篇笔记的内容都会附带其路径作为参考。
• obsidian_search_notes: 按名称搜索笔记（不区分大小写，支持部分匹配和正则表达式）。
• obsidian_read_notes_dir: 列出指定路径下的目录结构。
• obsidian_write_note: 在指定路径下创建新笔记。