@kazuph/mcp-obsidian

local-only server

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

Integrations

  • Allows access to Obsidian vault content for searching, reading, listing directory structure, and creating notes

MCP 黑曜石

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

快速入门(针对用户)

先决条件

配置

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

对于开发人员

先决条件

  • 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
  1. 修改位于以下位置的 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 :在指定路径创建新注释。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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

  1. Quick Start (For Users)
    1. Prerequisites
    2. Configuration
  2. For Developers
    1. Prerequisites
  3. Installation
    1. Configuration
      1. Available Tools
        ID: sed8z2tqq9