MCP 服务器

@kazuph/mcp-obsidian

用于 Claude Desktop 的 Obsidian vault 连接器 - 支持使用模型上下文协议 (MCP) 读取和写入 Markdown 笔记

笔记

开发者工具

Tools

obsidian_read_notes

Read the contents of multiple notes. Each note's content is returned with its path as a reference. Failed reads for individual notes won't stop the entire operation. Reading too many at once may result in an error.

obsidian_search_notes

Searches for a note by its name. The search is case-insensitive and matches partial names. Queries can also be a valid regex. Returns paths of the notes that match the query.

obsidian_read_notes_dir

Lists only the directory structure under the specified path. Returns the relative paths of all directories without file contents.

obsidian_write_note

Creates a new note at the specified path. Before writing, check the directory structure using obsidian_read_notes_dir. If the target directory is unclear, the operation will be paused and you will be prompted to specify the correct directory.

README

MCP Obsidian

用于 Obsidian vault 集成的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）搜索和读取您的 Obsidian 笔记。

快速开始（面向用户）

前提条件

Node.js 18+ (通过 brew install node 安装)
Obsidian vault
Claude Desktop (从 https://claude.ai/desktop 安装)

配置

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

您可以通过 Claude Desktop 菜单找到它：

打开 Claude Desktop
点击 Mac 菜单栏上的 Claude
点击 "Settings"（设置）
点击 "Developer"（开发者）
将以下内容添加到您的配置中：

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

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

面向开发者

前提条件

Node.js 18+ (通过 brew install node 安装)
Obsidian vault
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

配置

确保 Claude Desktop 已安装并正在运行。
如果您还没有全局安装 tsx，请安装：

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

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

您可以通过 Claude Desktop 菜单轻松找到它：

打开 Claude Desktop
点击 Mac 菜单栏上的 Claude
点击 "Settings"（设置）
点击 "Developer"（开发者）

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

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