Obsidian MCP サーバー

AI アシスタントが Obsidian Vault と対話できるようにし、メモやタグの読み取り、作成、編集、管理のためのツールを提供するMCP (Model Context Protocol)サーバー。

警告！！！

このMCPには読み取りと書き込みのアクセス権があります（許可した場合）。obsidian-mcpを使用してノートを管理する前に、Obsidian Vaultを必ずバックアップしてください。Gitの使用をお勧めしますが、どのバックアップ方法でも問題ありません。これらのツールはテスト済みですが、完全ではありません。また、このMCPは現在開発中です。

Related MCP server: Vault Cortex

特徴

• 保管庫内のメモを読んだり検索したりする

• 新しいメモとディレクトリを作成する

• 既存のメモを編集する

• メモの移動と削除

• タグの管理（追加、削除、名前の変更）

• 保管庫の内容を検索

要件

• Node.js 20 以上 (それ以下でも動作するかもしれませんが、テストしていません)

• 黒曜石の金庫

インストール

手動でインストールする

Claude Desktop 構成に追加:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "obsidian": {
            "command": "npx",
            "args": ["-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

/path/to/your/vault Obsidian Vaultへの絶対パスに置き換えてください。例：

MacOS/Linux:

"/Users/username/Documents/MyVault"

ウィンドウズ:

"C:\\Users\\username\\Documents\\MyVault"

設定を保存したら、Claude for Desktopを再起動してください。サーバーが接続されたことを示すハンマーアイコンが表示されます。

接続の問題がある場合は、次のログを確認してください。

• MacOS: ~/Library/Logs/Claude/mcp*.log

• Windows: %APPDATA%\Claude\logs\mcp*.log

Smithery経由でインストール

警告：私はSmitheryとは一切関係ありません。実際に使用してテストしたことはなく、可能であれば手動でインストールすることをお勧めします。

Smithery経由で Claude Desktop 用の Obsidian を自動的にインストールするには:

npx -y @smithery/cli install obsidian-mcp --client claude

発達

# Clone the repository
git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp

# Install dependencies
npm install

# Build
npm run build

次に、Claude Desktop 構成に追加します。

{
    "mcpServers": {
        "obsidian": {
            "command": "node",
            "args": ["<absolute-path-to-obsidian-mcp>/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

利用可能なツール

• read-note - メモの内容を読む

• create-note - 新しいノートを作成する

• edit-note - 既存のメモを編集する

• delete-note - メモを削除する

• move-note - ノートを別の場所に移動する

• create-directory - 新しいディレクトリを作成する

• search-vault - 保管庫内のノートを検索

• add-tags - メモにタグを追加する

• remove-tags - ノートからタグを削除する

• rename-tag - すべてのノートのタグの名前を変更する

• manage-tags - タグの一覧表示と整理

• list-available-vaults - 利用可能なすべてのボールトを一覧表示します（複数のボールトの設定に役立ちます）

ドキュメント

追加のドキュメントは、 docsディレクトリにあります。

• creating-tools.md - 新しいツールを作成するためのガイド

• tool-examples.md - 利用可能なツールの使用例

安全

このサーバーはObsidian Vaultディレクトリへのアクセスを必要とします。サーバーを設定する際は、以下の点にご注意ください。

• 目的のVaultディレクトリへのアクセスのみを提供する

• ツールアクションを承認する前に確認する

トラブルシューティング

よくある問題:

1. Claude Desktop にサーバーが表示されない

   • 設定ファイルの構文を確認する

   • ボールトパスが絶対パスであり、存在していることを確認してください

   • Claudeデスクトップを再起動します

2. 権限エラー

   • ボールトパスが読み取り/書き込み可能であることを確認する

   • 保管庫内のファイル権限を確認する

3. ツール実行の失敗

   • Claude Desktop のログを次の場所で確認してください:

     • macOS: ~/Library/Logs/Claude/mcp*.log

     • Windows: %APPDATA%\Claude\logs\mcp*.log

ライセンス

マサチューセッツ工科大学