Skip to main content
Glama

@kazuph/mcp-obsidian

by kazuph

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

local-only server

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

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

  1. 快速入门(针对用户)
    1. 先决条件
    2. 配置
  2. 对于开发人员
    1. 先决条件
  3. 安装
    1. 配置
      1. 可用工具

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          This is a connector to allow Claude Desktop (or any MCP client) to read and search any directory containing Markdown notes (such as an Obsidian vault).
          Last updated -
          1,530
          718
          JavaScript
          AGPL 3.0
        • -
          security
          F
          license
          -
          quality
          Provides semantic search capability over Obsidian vaults and exposes recent notes as resources to Claude through the MCP protocol.
          Last updated -
          5
          Python
        • -
          security
          F
          license
          -
          quality
          This project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.
          Last updated -
          598
          7
          JavaScript
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables AI assistants to read, write, and manipulate notes in your Obsidian vault through a standardized interface.
          Last updated -
          598
          TypeScript
          ISC License

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/kazuph/mcp-obsidian'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server