-
security-
license-
qualityThis 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 -
681
1,142
AGPL 3.0
MCP 黑曜石
用于 Obsidian Vault 集成的模型上下文协议服务器。这允许 Claude Desktop（或任何 MCP 客户端）搜索和阅读您的 Obsidian 笔记。
快速入门（针对用户）
先决条件
Node.js 18+（通过
brew install node安装）黑曜石金库
Claude Desktop（从https://claude.ai/desktop安装）
配置
打开您的 Claude Desktop 配置文件：
~/Library/Application Support/Claude/claude_desktop_config.json
您可以通过 Claude 桌面菜单找到它：
打开 Claude 桌面
在 Mac 菜单栏上单击 Claude
点击“设置”
点击“开发者”
将以下内容添加到您的配置中：
{
"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
配置
确保 Claude Desktop 已安装并正在运行。
如果还没有安装 tsx，请全局安装：
npm install -g tsx
# or
pnpm add -g tsx
修改位于以下位置的 Claude Desktop 配置：
~/Library/Application Support/Claude/claude_desktop_config.json
您可以通过 Claude Desktop 菜单轻松找到它：
打开 Claude 桌面
在 Mac 菜单栏上单击 Claude
点击“设置”
点击“开发者”
将以下内容添加到您的 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：在指定路径创建新注释。
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 笔记
Related Resources
Related MCP Servers
- -security-license-qualityA local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.Last updated -362MIT License
- -security-license-qualityProvides semantic search capability over Obsidian vaults and exposes recent notes as resources to Claude through the MCP protocol.Last updated -8
- -security-license-qualityIntegration project for Model Context Protocol (MCP) servers with Claude Desktop App, enabling filesystem operations, development support, and file management through natural language.Last updated -