Smart Connections MCP

🚀 スマートコネクションMCPサーバー

このサーバーは、セキュリティを重視したSmart Connections用のMCPサーバーです。読み取り専用で、パスの検証が行われ、監査可能です。Smart Connectionsの埋め込み情報をClaude Codeやその他のMCPクライアントに公開し、Obsidianボルトのセマンティック検索を可能にします。

🚀 クイックスタート

Claude CodeからObsidianボルトのセマンティック検索が必要になったため、このサーバーが開発されました。既存のオプションにはいくつかの問題があります。

• パス検証がない - ユーザー入力が直接ファイル操作に渡される
• 書き込みアクセス - 必要のない変更ツールが公開されている
• 重い依存関係 - 本質的にベクトル数学であるものにPyTorch/transformersを使用している

この実装では、以下の特徴があります。

• 最小限の依存関係 - MCP SDK + Transformers.js（テキスト検索用）
• セキュリティ重視 - realpathを使用したパス検証、シンボリックリンク検出
• 監査可能 - 実際に読める小さなTypeScriptコードベース

✨ 主な機能

• テキスト検索 - ノートパスだけでなく、平文でクエリを実行できます。
• セマンティック検索 - Smart Connectionsの埋め込み情報を使用します。
• ローカル推論 - Transformers.js（Smart Connectionsと同じモデル）を使用します。
• 読み取り専用 - 書き込み操作やシェル実行はありません。
• セキュア - 厳格なパス検証、制限付きのレスポンス
• オフライン - Obsidianを実行せずに動作します。

🔧 セキュリティモデル

📦 インストール

前提条件

• Node.js 18以上
• Smart ConnectionsプラグインがインストールされたObsidian
• 埋め込み情報が構築されている（Obsidianでボルトを開き、Smart Connectionsがインデックスを作成するのを待つ）

セットアップ

git clone https://github.com/gogogadgetbytes/smart-connections-mcp
cd smart-connections-mcp
npm install
npm run build

Claude Codeの設定

Claude Codeの設定に以下を追加します。

claude mcp add smart-connections \
  -e VAULT_PATH="/path/to/your/obsidian/vault" \
  -- node /path/to/smart-connections-mcp/dist/index.js

または、手動で~/.claude.jsonに以下を追加します。

{
  "mcpServers": {
    "smart-connections": {
      "command": "node",
      "args": ["/path/to/smart-connections-mcp/dist/index.js"],
      "env": {
        "VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

Claude Codeを再起動してサーバーを読み込みます。

💻 使用例

基本的な使用法

設定が完了すると、Claude Codeは以下のツールを使用できます。

テキストによる検索

"Search my vault for notes about backup strategies"
→ Uses search_by_text tool

類似ノートの検索

"Find notes similar to Topics/Claude_Code.md"
→ Uses search_similar tool

ノート内容の取得

"Show me the content of Topics/Obsidian.md"
→ Uses get_note tool

インデックス付きノートの一覧表示

"What notes are indexed in my vault?"
→ Uses list_indexed tool

高度な使用法

📚 ドキュメント

設定

制限事項

• 単一のボルト - MCPサーバーインスタンスごとに1つのボルトを設定します。
• Smart Connectionsからのインデックス - ノートの埋め込み情報はプラグインから取得され、テキストクエリはローカルで埋め込まれます。
• 書き込みアクセスなし - 設計上、Obsidianで編集を行います。
• 初回実行時にモデルをダウンロード - ~50MBのモデルが~/.cache/huggingface/にキャッシュされます。

開発

# ビルド
npm run build

# MCPインスペクターでテスト
npx @modelcontextprotocol/inspector node dist/index.js

貢献方法

詳細はCONTRIBUTING.mdを参照してください。セキュリティに焦点を当てたPRを歓迎します。

📄 ライセンス

MIT - LICENSEを参照してください。

クレジット

• Smart Connections by Brian Petro
• Model Context Protocol by Anthropic