Skip to main content
Glama

GrokBot ↔ Obsidian ブリッジ

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

GrokBot から Obsidian へのブリッジ概要

このリポジトリは、デフォルトで 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: vault-server-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つの接続は分けてください:

クライアント

このリポジトリ

オプションの Composio 接続

Grok Bot

Grok プラグインをインストールし、obsidian-bridge に接続

Composio Connect を2番目の MCP コネクタとして追加

Cursor

Cursor プラグインをインストールするか、この MCP URL を追加

Composio Connect を2番目の MCP サーバーとして追加

Codex

Codex プラグインをインストールするか、この MCP URL を追加

Composio のネイティブ Codex プラグインを優先するか、Connect MCP を明示的に選択

ここにある .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 を参照してください。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Remote MCP server for Obsidian vault access, giving Claude read/search/archive access to markdown notes via OAuth 2.1 + PKCE auth.
      2
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Read-only MCP server that exposes an Obsidian vault to LLM clients over Streamable HTTP, letting them browse the accessible tree, read notes, run full-text searches, and resolve wiki-links and backlinks within a share-filtered note set. Access is limited by an operator-editable sharing config that is default-deny and never writes to the vault.
      3,713 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Gives AI clients OAuth-secured, remote read and approval-gated write access to an Obsidian vault, including search, backlinks, diffs, and audited proposals. It also proxies a headless Anki container through a scoped MCP gateway for flashcard management.
      MIT