bitbonsai/mcpvault

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

1704 stars 133 forks 质量 89 趋势 45MIT

Repository Install

一个轻量级模型上下文协议（MCP）服务器，用于安全访问Obsidian保险库

概览

基于模型上下文协议（MCP）标准的Obsidian保险库通用AI桥接器。连接任何兼容MCP的AI助手到您的知识库——可支持Claude、ChatGPT及未来的AI工具。该服务器提供安全的笔记读写访问，同时防止YAML前置文件损坏。可支持任何兼容MCP的AI助手，包括Claude Desktop、Claude Code、ChatGPT Desktop（Enterprise+）、OpenCode、Gemini CLI、OpenAI Codex、IntelliJ IDEA 2025.1+、Cursor IDE、Windsurf IDE、Ontheia以及采用MCP标准的未来AI平台。 https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c - 将此复制到claude_desktop_config.json： - 复制到~/.config/opencode/opencode.json 把/path/to/your/vault替换成你实际的Obsidian vault路径。关于其他平台，请参见下方详细配置指南。 4. - “在我的黑曜石保险库里列出文件” - “阅读我的笔记，叫'project-ideas.md'” - “创建一个包含今天日期的新笔记”

概述（AI 翻译）

本地MCP服务器允许兼容的客户端在Obsidian保险库中读取、搜索和编辑笔记。MCPVault直接处理保险库文件，限制文件操作至配置好的保险库根节点，并保留未更改前件字段的格式。

https://mcpvault.org

更新日志

支持的客户

配置示例包括 Claude Desktop、Claude Code、ChatGPT Desktop （Enterprise+）、OpenCode、Gemini CLI、OpenAI Codex、IntelliJ IDEA 2025.1+、Cursor、Windsurf 和 Ontheia。其他客户端如果支持本地标准 MCP 服务器，也可以使用 MCPVault。

https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c

快速开始

安装Node.js运行时：
测试服务器：

如果使用已发布的软件包：

配置你的AI客户端：

Claude 桌面 - 复制到claude_desktop_config.json：

Claude代码 - 复制到~/.claude.json：

OpenCode - 复制到~/.config/opencode/opencode.json

把/path/to/your/vault替换成你实际的黑曜石金库路径。

关于其他平台，请参见下方详细配置指南。

用你的AI测试：

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

MCPVault

A local MCP server that lets compatible clients read, search, and edit notes in an Obsidian vault. MCPVault works directly with vault files, restricts file operations to the configured vault root, and preserves formatting for unchanged frontmatter fields.

Supported clients

Configuration examples are available for Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), OpenCode, Gemini CLI, OpenAI Codex, IntelliJ IDEA 2025.1+, Cursor, Windsurf, and Ontheia. Other clients can use MCPVault if they support local stdio MCP servers.

https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c

Quick start

Install Node.js runtime:

# Download from https://nodejs.org (v20.0.0 or later)
# or use a package manager like nvm, brew, apt, etc.

Test the server:

If using the published package:

npx @modelcontextprotocol/inspector npx @bitbonsai/mcpvault@latest /path/to/your/vault

Configure your AI client:

Claude Desktop - Copy this to claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["@bitbonsai/mcpvault@latest", "/path/to/your/vault"]
    }
  }
}

Claude Code - Copy this to ~/.claude.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",

在 GitHub 查看完整 README

安装

npx @bitbonsai/mcpvault@latest /path/to/your/vault

新手？先看 mcpskill.org 教程 →

配置

{
     "mcpServers": {
       "obsidian": {
         "command": "npx",
         "args": ["@bitbonsai/mcpvault@latest", "/path/to/your/vault"]
       }
     }
   }