MCP 黑曜石

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

快速入门（针对用户）

先决条件

• Node.js 18+（通过brew install node安装）

• 黑曜石金库

• Claude Desktop（从https://claude.ai/desktop安装）

配置

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

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

1. 打开 Claude 桌面

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 保管库路径。

Related MCP server: MCP Tools for Obsidian

对于开发人员

先决条件

• Node.js 18+（通过brew install node安装）

• 黑曜石金库

• 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

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

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

1. 打开 Claude 桌面

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 ：在指定路径创建新注释。