aaronsb/obsidian-mcp-plugin

Developer tools

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

467 stars 54 forks 品質 78 トレンド 40MIT

Repository Install

Obsidian向けの高性能モデルコンテキストプロトコル(MCP)サーバーで、AIツールに意味操作やHTTPトランスポートを通じて直接のボールトアクセスを提供します。

概要

外部ノードプロセスを起動せず、ブリッジする別のREST-APIプラグインもありません。サーバーがプラグインです。セットアップはドラッグ&ドロップで、.mcpbバンドルをClaude Desktopに置き、キーを貼り付けるだけです。各操作群を公開し、単一の呼び出しではなく(Vaultツールだけで13の操作(リスト、読み取り、作成、検索、移動、分割、結合など)を扱い、一流のサポートに加え、リンク、タグ、バックリンクをまたぐグラフトラバーサルも可能です。また、すべての操作はあなたが設定した権限(読み取り専用モード、操作ごとの制御、パス許可/ブロックリスト)を尊重するため、AIはあなたが許可したことだけを実行し、無制限のボルト操作はしません。 — Claude Desktop、Claude Code、Cline、Continue.dev、そしてローカルMCPを話すすべてのもの。モデルコンテキストプロトコルは、AIアシスタントが外部のツールやデータとやり取りできるオープンスタンダードです。これを使うのに理解する必要はありません — クイックスタートは3ステップで構成されています。

概要（AI 翻訳）

📦 Obsidian Community Plugin ディレクトリ→で利用可能

ObsidianのVaultを、_inside_Obsidianを動かすMCPサーバーを通じて、どのAIアシスタントからも読み書き、検索、トラバースできます。

外部ノードプロセスを起動せず、ブリッジする別のREST-APIプラグインもありません。サーバーはプラグインそのものです。セットアップはドラッグ&ドロップで、.mcpbバンドルをClaude Desktopに落とし、キーを貼り付けるだけです。

8つの強力なツールを公開し、それぞれが一連の操作群を扱い、単一の呼び出しではなく(vaultツールだけでリスト、読み取り、作成、検索、移動、分割、結合など13個を処理します)、一流のDataviewとBasesのサポートに加え、リンク、タグ、バックリンクをまたぐグラフトラバーサルも可能です。そしてすべての操作はあなたが設定した権限—読み取り専用モード、操作ごとのコントロール、パスの許可/ブロックリスト—を尊重するため、AIはあなたが許可した権限のみを実行し、無制限のヴォールトの実行はしません。

**MCP互換クライアントならすべて動作します — Claude Desktop、Claude Code、Cline、Continue.dev、そしてローカルMCPを話すすべての機器。

**MCPは初めてですか??モデルコンテキストプロトコルは、AIアシスタントが外部ツールやデータとやり取りできるオープンスタンダードです。

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

README

以下は原文 README の抜粋です。原文を見る。

Semantic Notes Vault MCP

📦 Available in the Obsidian Community Plugin directory →

Read, write, search, and traverse your Obsidian vault from any AI assistant — through an MCP server that runs inside Obsidian.

No external Node process to launch, no separate REST-API plugin to bridge through: the server is the plugin. Setup is a drag-and-drop — drop the .mcpb bundle onto Claude Desktop, paste your key, done.

It exposes 8 powerful tools — each a whole family of operations, not a single call (the vault tool alone handles 13: list, read, create, search, move, split, combine, and more) — with first-class Dataview and Bases support plus graph traversal across links, tags, and backlinks. And every operation respects the permissions you set — a read-only mode, per-operation controls, and path allow/block lists — so the AI only ever does what you’ve allowed, not unrestricted run of your vault.

Works with any MCP-compatible client — Claude Desktop, Claude Code, Cline, Continue.dev, and anything that speaks local MCP.

New to MCP? The Model Context Protocol is the open standard that lets AI assistants interact with external tools and data. You don’t need to understand it to use this — the Quick Start is three steps.

Quick Start

Prerequisites: an MCP-compatible AI client like Claude Desktop, Claude Code, or Continue.dev.

📦 ──drag──▶ 🤖💬

Download the .mcpb bundle from the plugin’s config page → drag it onto Claude Desktop → paste your key. Done.

For most people that’s the entire setup. The numbered steps below spell it out, then cover other MCP clients.

1. Install the Plugin

Via Obsidian Community Plugins

Open Settings → Community plugins → Browse
Search for “Semantic Notes Vault MCP”
Install and enable — or install straight from the plugin listing

Via BRAT (for beta testing)

Install BRAT
Add beta plugin: aaronsb/obsidian-mcp-plugin

2. Configure Your AI Client

Three onboarding paths, ordered by audience. All three are also shown in the plugin’s Settings tab with copy-ready values.

📦 → 🤖 Claude Desktop — one-click .mcpb install (recommended)

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

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

設定

{
  "mcpServers": {
    "obsidian-vault": {
      "transport": {
        "type": "http",
        "url": "http://localhost:3001/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}