obsidian-mcp

Name: obsidian-mcp
Availability: InStock
Author: Steven Stavrakis

Obsidian MCP Serverは、AIアシスタントがObsidianのボールトと相互作用できるようにするMCPサーバーです。ノートやタグの管理、作成、編集が可能で、ノートの検索機能も備えています。ただし、書き込みアクセスがあるため、使用前にバックアップを推奨しています。

GitHub

GitHubスター

523

ユーザー評価

未評価

お気に入り

閲覧数

フォーク

イシュー

インストール方法

難易度

中級

推定所要時間

10-20 分

必要な環境

Node.js 20以上

Obsidianボールト

インストール方法

前提条件

Node.js: 20以上

Obsidianボールト

インストール手順

1. 手動インストール

Claude Desktopの設定に追加します：

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

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

/path/to/your/vaultをObsidianボールトの絶対パスに置き換えます。例： macOS/Linux:

json
"/Users/username/Documents/MyVault"

Windows:

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

設定を保存した後、Claudeを再起動します。接続が成功すると、ハンマーアイコンが表示されます。

2. Smitheryを使用したインストール

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

トラブルシューティング

接続問題が発生した場合は、以下のログを確認してください：

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

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

設定方法

基本設定

Claude Desktop設定

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または%APPDATA%\Claude\claude_desktop_config.json（Windows）を編集：

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

環境変数

必要に応じて以下の環境変数を設定：

bash
export API_KEY="your-api-key"
export DEBUG="true"

セキュリティ設定

APIキーは環境変数または安全な設定ファイルに保存

ファイルアクセス権限の適切な設定

ログレベルの調整

使用例

基本的な使用方法

Claude Desktopでの使用

1MCPサーバーの起動確認

Claude Desktopを開き、設定が正しく読み込まれていることを確認してください。

2基本コマンドの実行


   Available tools from this MCP server:
   - read-note: Read the contents of a note
   - create-note: Create a new note

プログラムでの使用

javascript
// JavaScript例（Node.js）
const { MCPClient } = require('@modelcontextprotocol/client');

const client = new MCPClient();
await client.connect();

// ツールの実行
const result = await client.callTool('read-note', {
  noteId: 'example-note-id'
});

console.log(result);

応用例

自動化スクリプト

bash
#!/bin/bash
バッチ処理の例

for file in *.txt; do
  mcp-tool process "$file"
done

API統合

python
Python例
import requests

def call_mcp_tool(tool_name, params):
    response = requests.post(
        'http://localhost:3000/mcp/call',
        json={
            'tool': tool_name,
            'parameters': params
        }
    )
    return response.json()

使用例
result = call_mcp_tool('read-note', {'noteId': 'example-note-id'})