bitbonsai/mcpvault

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

1704 stars 133 forks 品質 89 トレンド 45MIT

Repository Install

安全なObsidianボールトアクセスのための軽量モデルコンテキストプロトコル(MCP)サーバー

概要

Model Context Protocol(MCP)標準を用いたObsidian Vault向けの汎用AIブリッジです。任意のMCP互換AIアシスタントをナレッジベースに接続できます。Claude、ChatGPT、将来のAIツールと連携可能です。このサーバーは、YAMLのフロントマター破損を防ぎつつ、ノートへの安全な読み書きアクセスを提供します。 Claude Desktop、Claude Code、ChatGPT Desktop(Enterprise+)、OpenCode、Gemini CLI、OpenAI Codex、IntelliJ IDEA 2025.1+、Cursor IDE、Windsurf IDE、Ontheia、そしてMCP標準を採用した将来のAIプラットフォームなど、あらゆる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. - 「私のObsidian Vaultのファイルリスト」- 「『project-ideas.md』という私のメモを読んで」- 「今日の日付で新しいノートを作成」

概要（AI 翻訳）

互換性のあるクライアントがObsidianボールト内のノートを読み、検索し、編集できるローカルMCPサーバーです。MCPVaultはVaultファイルを直接扱い、ファイル操作を設定済みのVaultルートに制限し、変更されていないフロントマターフィールドのフォーマットを保持します。

https://mcpvault.org

変更ログ

サポートクライアント

Claude Desktop、Claude Code、ChatGPT Desktop (Enterprise+)、OpenCode、Gemini CLI、OpenAI Codex、IntelliJ IDEA 2025.1+、Cursor、Windsurf、Ontheiaの設定例が利用可能です。他のクライアントはローカルのstdio MCPサーバーをサポートしている場合、MCPVaultを利用できます。

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

クイックスタート

実行時Node.jsインストール:
サーバーのテスト:

公開パッケージを使用する場合:

AIクライアントの設定:

Claude Desktop - これをclaude_desktop_config.jsonにコピーしてください:

Claudeコード - これを~/.claude.jsonにコピーしてください:

OpenCode - これを[[T4]にコピーしてください]

/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

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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