GrokBot ↔ Obsidian ブリッジ

Grok Bot やその他の互換 MCP クライアントがセルフホストの Obsidian ボールトに到達できるようにする、小規模でフェイルクローズな OAuth リバースプロキシです。公開プロセスはオーナー承認で終了します。認証済みの Streamable HTTP は、ループバック上の Optimike Obsidian MCP バックエンドにのみ転送されます。

このリポジトリは、デフォルトで standard ツールプロファイルと headless-readonly ランタイムを使用します。実際のボールト、ホスト名、資格情報、プライベートパス、ノートは含まれていません。

仕組み

1. このリポジトリをクローンし、ガイド付きインストーラーを実行します。

2. インストーラーは公開 Optimike Obsidian MCP v3.0.0 を固定してビルドし、ブリッジをローカル venv にインストールし、モード 600 の環境ファイルを書き込みます。プロキシの起動、Optimike の起動、ボールトへのアクセスは行いません。

3. 自分で Optimike をループバック上で起動し、次にこのプロキシをループバック上で起動し、プロキシの前に HTTPS を配置します。

4. Grok Bot は OAuth を検出し、クライアントを登録し、オーナー承認を待ちます。PKCE 交換後、/mcp を呼び出します。プロキシはクライアントシークレットを除去し、セッションを Optimike に転送します。

Optimike のソースはここにはベンダリングされていません。docs/UPSTREAM.md を参照してください。

Related MCP server: obsidian-vault-mcp

要件

• Python 3.11+

• Node.js 22.7.5+ と npm

• git

• 127.0.0.1:8099 に転送する公開 HTTPS ホスト名

• インストーラーによってタグ v3.0.0 (0a40387206a19deb6430f9b61b81fc7a07704717) に固定された Optimike チェックアウト

• すでに管理しているボールトのコピー。このインストーラーはボールトを作成、開く、変更することはありません。

クローン後の1コマンド

./scripts/install.sh --non-interactive

スクリプトは root と sudo を拒否し、ダウンロードをシェルにパイプせず、生成されたオーナーコードを出力しません。次にヘルスを確認します:

python3 scripts/doctor.py

.env.local の残りのローカルボールトプレースホルダーを入力します。Optimike を自分で headless-readonly、standard、readonly、本番 JWT 認証、生成された内部シークレットで起動します:

set -a
. ./.env.local
set +a
cd .runtime/upstream
NODE_ENV=production MCP_TRANSPORT_TYPE=http MCP_HTTP_HOST=127.0.0.1 \
MCP_HTTP_PORT=3010 MCP_AUTH_MODE=jwt \
MCP_AUTH_SECRET_KEY="$OBSIDIAN_BRIDGE_UPSTREAM_JWT_SECRET" \
node dist/index.js

2番目のターミナルで、公開 OAuth プロキシを起動します:

.venv/bin/python -m obsidian_bridge serve

GET /health は {"status":"ok"} を返すはずです。Python ポートを直接公開しないでください。

プラグインの設定

python3 scripts/configure_plugin.py https://mcp.example.com/mcp

生成された mcp.json と .mcp.json には公開 URL のみが含まれます。Authorization ヘッダーを追加しないでください。Grok Bot、Codex、Cursor は OAuth ディスカバリーと PKCE を使用します。

このブリッジの横に Composio を追加

Corey Ganim の Grok Bot のヒント では、Composio Connect を使用して、クライアントのネイティブコネクタカタログを超えることを説明しています。Composio は Connect を、7つのメタツールを通じて1000以上のアプリに対応する1つのホスト型 MCP エンドポイントと説明しています。文字通りすべての MCP サーバーというわけではなく、このリポジトリにバンドルされているわけでもありません。

2つの接続は分けてください:

ここにある .grok-plugin、.cursor-plugin、.codex-plugin マニフェストは、読み取り専用の Obsidian ブリッジのみをインストールします。Composio トラフィックはボールトを通過せず、Composio がこのブリッジを置き換えることはありません。完全なセットアップモデルと安全境界については、チュートリアル を参照してください。

セキュリティモデル

• DCR、S256 PKCE、ローテーション付きリフレッシュトークンを備えたシングルオーナー OAuth 2.1

• 承認ページではオーナーコードが必要で、ベアラートークンになることはありません

• ループバックバインド。TLS はこのプロセスの外にあります

• クライアントのベアラートークンは除去され、Optimike がリクエストを見る前に、短期間有効で別途署名された内部 JWT に置き換えられます

• /mcp/full と非読み取り専用モードはフェイルクローズします

• シークレットはモード 600 のローカルファイルに保持され、git、argv、stdout には出ません

エンドポイントを公開する前に docs/SECURITY.md と docs/ARCHITECTURE.md を読んでください。

テストと監査

python3 -m unittest discover -s tests -v
python3 src/privacy_scan.py --root .
python3 scripts/audit_git_history.py

ライセンス

このブリッジは MIT です。Optimike Obsidian MCP は別の Apache-2.0 プロジェクトであり、このツリーにコピーされていません。docs/UPSTREAM.md を参照してください。