セカンドブレイン MCP サーバー

Obsidianボルトへのインテリジェントで安全な読み取り専用アクセスを提供するMCPサーバーです。LLM向けにセマンティック検索やメタデータフィルタリングなどを可能にします。

特徴

• 効率的なデータベースストレージ: 大規模ボルト向けのSQLiteベースのインデックス作成と永続的なキャッシュ

• メモリモードオプション: 小規模ボルトや開発向けのオプションのインメモリインデックス作成

• セマンティック検索: ファジーマッチングによる全ノートの全文検索

• タグベースのフィルタリング: 階層タグによる検索 (例: work/puppet, tech/golang)

• パスベースのフィルタリング: ディレクトリパターンによるフィルタリング (例: Work/Puppet/**)

• 時間的クエリ: 作成日/更新日によるノートのフィルタリング

• メタデータフィルタリング: タイプ、ステータス、カテゴリによるフィルタリング

• ノート取得: 特定のノートの全文を取得

• スマート要約: ノートコレクションの要約を生成

• 最近のノート: 最近更新されたノートへのクイックアクセス

• アーカイブ制御: 検索にアーカイブ済みノートを含めるオプション

• 知識のギャップ: ボルト全体で孤立したウィキリンクや未解決の質問を検出

• 間隔レビュー: 定期的なレビューのために、リンクの重要度に基づいてランク付けされた古いノートを表示

• 関連ノート: 共有リンク、タグ、タイトルの重複に基づいたスコアベースの関連ノート発見

• ボルトグラフ: ハブ検出、リンク切れ統計、孤立分析を含む完全なリンクグラフ

• セキュリティ: パス・トラバーサル保護、ファイルサイズ制限、入力バリデーション

Related MCP server: Obsidian MCP Server

ボルトの互換性

このサーバーはObsidianボルトだけでなく、あらゆるMarkdownファイルのディレクトリで動作します。ファイルシステム上で純粋に動作し、Obsidianアプリへの依存関係はありません。

Foamでの使用

--vault-path にFoamワークスペースのルートを指定してください。設定変更は不要です：

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/foam-workspace"

Foamの機能でそのまま動作するもの：

• グラフツールで解決される [[wikilinks]] および [[target|aliased links]]

• YAMLフロントマタータグ（インライン [tag1, tag2] およびブロックリスト形式の両方）

• ネストされたタグ階層 (work/backend)

• サブフォルダ構造 (notes/, journal/, projects/)

• フロントマターのないノートも安全なデフォルト値でインデックス化

.vscode/ フォルダは自動的にインデックスから除外されます。

読み取り専用設計

このMCPサーバーは、AIとの対話中にボルトを安全に保つため、意図的に読み取り専用となっています。以下の機能を提供します：

• ✅ ノートの検索と取得

• ✅ メタデータとパスによるフィルタリング

• ✅ 要約と統計の生成

• ❌ ノートの作成や編集は不可

• ❌ ファイルの変更は不可

書き込み操作が必要な場合は、組み込みの安全チェックを備えた専用のObsidianプラグインの使用を検討してください。

インストール

設定とインストール

ワンクリックインストール

• VS Code:

• VS Code Insiders:

• Cursor:

手動インストール

インストールは不要です！npxで直接使用できます：

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

ローカル開発

cd second-brain-mcp
npm install
npm run build
npm link

これにより、サーバーが second-brain-mcp としてグローバルに使用可能になります。

Claude Code & Claude Desktop

Claude Code

以下のコマンドでサーバーを追加します：

claude mcp add second-brain -- npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Claude Desktop

Claude Desktopの設定ファイルに追加します：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/path/to/your/vault"
      ]
    }
  }
}

ボルト構造、CLI引数、設定例については docs/configuration.md を参照してください。

完全なMCP APIリファレンスと使用例については docs/api.md を参照してください。

Claude Codeでの使用

MCP設定ファイルに追加します。

単一ボルトの設定

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json を編集 Windows: %APPDATA%\Claude\claude_desktop_config.json を編集

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/ioanniskarasavvaidis/Documents/Obsidian Vault"
      ]
    }
  }
}

複数ボルトの設定

複数のボルトインスタンスを設定できます：

{
  "mcpServers": {
    "second-brain-personal": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Personal Vault"
      ]
    },
    "second-brain-work": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Work Vault"
      ]
    }
  }
}

ローカル開発環境のセットアップ

npm link を使用してローカルで開発する場合：

{
  "mcpServers": {
    "second-brain": {
      "command": "second-brain-mcp",
      "args": ["--vault-path", "/path/to/your/vault"]
    }
  }
}

その他のクエリ例については docs/examples.md を参照してください。

ドキュメント

以下については docs/README.md を参照してください：

• APIリファレンス

• 設定とCLIオプション

• クエリ例

• 開発とストレージのアーキテクチャ

• 貢献方法

• 依存関係

• アーキテクチャとデータベーススキーマ

• セキュリティと検索

• クエリ例

• 開発

• 貢献

• 依存関係

• ライセンス

クイックスタート

npxを使用してすぐにサーバーを実行できます（インストール不要）：

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

または、Claude Code/Claude Desktopに追加してください（以下の「設定とインストール」を参照）。

トラブルシューティングとFAQ

一般的な問題と解決策については docs/configuration.md を参照してください。

検索の重み付けとスコアリングの詳細については docs/search.md を参照してください。

セキュリティ機能と保護の詳細については docs/security.md を参照してください。

開発ワークフローとストレージの詳細については docs/development.md を参照してください。

貢献ガイドラインについては docs/contributing.md を参照してください。

ストレージアーキテクチャ

このサーバーは、効率的なインデックス作成と永続的なキャッシュのためにデフォルトでSQLiteデータベースストレージを使用します：

• データベースモード（デフォルト）: インデックス化されたノートをボルト内の .second-brain-mcp/notes.db に保存します

  • 永続的なインデックス作成（サーバー再起動後も保持）

  • 大規模ボルト（1000ノート以上）で効率的

  • SQLite FTS5による全文検索

  • メモリ使用量が少ない

• メモリモード（オプション）: インメモリストレージには --use-memory フラグを使用します

  • 小規模ボルト（100ノート未満）で高速

  • ディスクI/Oオーバーヘッドなし

  • 開発やテストに便利

  • ファジー検索にFuse.jsを使用

アーキテクチャ図については docs/architecture.md を参照してください。 データベーススキーマについては docs/database-schema.md を参照してください。

アーキテクチャ

• src/index.ts: ツールハンドラーを備えたMCPサーバーの実装

• src/vault.ts: ボルトのインデックス作成のオーケストレーションとセキュリティ制御

• src/storage.ts: ストレージインターフェースの抽象化

• src/database-storage.ts: SQLiteベースのストレージ実装

• src/memory-storage.ts: Fuse.jsを使用したインメモリストレージ実装

• src/storage-factory.ts: モード選択のためのストレージファクトリーパターン

• src/config.ts: デフォルト値を含む設定管理

• src/types.ts: TypeScriptの型定義とバリデーションユーティリティ

• src/__tests__/: 重要な機能のユニットテスト

本番環境および開発環境の依存関係の完全なリストについては docs/dependencies.md を参照してください。

サポート

second-brain-mcpが役に立った場合は、GitHubでのスポンサーやコーヒーを奢ることを検討してください。

ライセンス

MIT