Skip to main content
Glama
kazuph

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

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

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

Latest Blog Posts

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