WebMCP Today

WebMCP Today MCP ブリッジ

@webmcp-today/mcp-bridge は、WebMCP Today ブラウザー拡張機能を通じて対応サイトに WebMCP ツールを追加するパッケージのレジストリ、 WebMCP Today 用の MCP サーバーです。

MCP クライアントからレジストリパッケージの閲覧や公開、アカウント単位の パッケージピンの管理ができます。また、オプションのローカルブラウザーブリッジをインストールすると、ユーザーが選択したブラウザーのタブで稼働中の WebMCP ツールを検出して呼び出せます。

インストールと設定

Node.js 20 以降が必要です。stdio 対応の MCP クライアントを設定し、npx で パッケージを実行します。

{
  "mcpServers": {
    "webmcp-today": {
      "command": "npx",
      "args": ["--yes", "@webmcp-today/[email protected]"]
    }
  }
}

デフォルトのレジストリは https://webmcp.today です。別の互換性のあるレジストリエンドポイントを使用する場合に限り、 WEBMCP_TODAY_API_URL を設定してください。

レジストリ API キー（任意）

公開パッケージの検出に認証情報は不要です。パッケージピン、公開、パッケージメタデータの更新など、 アカウントおよびパブリッシャーの認証が必要な操作を利用するには、MCP サーバー環境で WEBMCP_TODAY_API_KEY を設定してください。WebMCP Today の設定で API キーを作成してください。プロンプト、 パッケージ定義、ソース管理にキーを含めないでください。

{
  "mcpServers": {
    "webmcp-today": {
      "command": "npx",
      "args": ["--yes", "@webmcp-today/[email protected]"],
      "env": {
        "WEBMCP_TODAY_API_KEY": "<your-api-key>"
      }
    }
  }
}

機能

このサーバーは、次のカテゴリのツールを提供します。

• レジストリの検出 — URL に対応するパッケージの検索、パッケージの閲覧、 最新バージョンのパッケージの取得、レジストリ統計の確認。
• アカウントと公開 — アカウント単位のパッケージピンの確認と管理、 パッケージの公開とバージョンの追加、パッケージメタデータの更新。これらの操作には API キーが必要です。アカウントのピンはブラウザーにパッケージをインストールするものではありません。 返されるインストールリンクによって、明示的なブラウザーでの同意手順をユーザーに委ねます。
• WebMCP ライブブリッジ — ユーザーが選択した、表示中の Chrome または Brave のタブの一覧表示とフォーカス、 稼働中のツールの一覧表示、検出時に返されたドキュメントおよびツールリストの世代情報を使った 選択ツールの実行。
• ブリッジ管理 — 対応する macOS ブラウザーで、ファーストパーティのネイティブブリッジをインストール、確認、削除。

ライブブラウザーブリッジ

ライブブリッジは任意です。WebMCP Today 拡張機能と、 macOS の Chrome または Brave でのファーストパーティネイティブホストのセットアップが必要です。MCP サーバーの設定後、 明示的な承認を得て、たとえば次のように setup_webmcp_bridge を呼び出してください。

{ "browser": "chrome", "confirm": true }

セットアップでは、バンドルされたネイティブホストを ~/.config/webmcp-today にコピーし、ブラウザーの Application Support ディレクトリには、このブリッジのネイティブメッセージングマニフェストのみを書き込みます。 Brave では、独自のマニフェストと Chrome 互換のマニフェストの両方が書き込まれます。 Node 20 以降または Bun で動作します。ブリッジのシークレットを公開せずにインストール状況を確認するには、 get_webmcp_bridge_status を使用してください。

ブリッジは、ユーザーが選択したアクティブで表示中の Chrome または Brave のタブのみを操作します。 WebMCP の有効化、任意の JavaScript の実行、Chrome DevTools Protocol のプロキシ、HTTP ポートの公開は行いません。 レジストリから挿入されたツールは、ページの認証済み Cookie を使って同一オリジンのページリクエストを行うため、ログイン中のサイトアカウントとして操作できます。 ページ側で挿入された WebMCP ツールが拒否される場合もあります。また、検出後にページまたはそのツールが変更された場合は、 再度検出が必要です。

拡張機能のローカルフォールバックは、現在の WebMCP テストフラグがなくても、このブリッジを通じてツールを提供できます。 ただし、Chrome のネイティブエージェントが現在のブラウザープレビューで挿入されたツールを認識するには、そのフラグが引き続き必要です。

確認と再試行

• 破壊的操作としてマークされたレジストリから挿入されたツールでは、ページレベルの window.confirm プロンプトが表示されます。選択したタブで承認してください。
• setup_webmcp_bridge と uninstall_webmcp_bridge は、confirm: true を指定して呼び出すまでファイルシステムに変更を加えません。
• execution-timeout が発生した場合、ブラウザーでツールの呼び出しが完了している可能性があります。再試行する前に結果を確認してください。dispatch-failed は呼び出しがディスパッチされなかったことを意味するため、再試行できます。
• Brave のインストールを削除しても、Chrome 互換マニフェストは意図的に残ります。ブリッジが完全に削除されたと判断する前に、両方のブラウザーを終了してから、ツールの報告する手順に従って確認済みの Chrome アンインストールを実行してください。

開発

リポジトリを開発するには、依存関係をインストールし、パッケージのテストを実行してください。

bun install
bun run --filter @webmcp-today/mcp-bridge test

リンク

• WebMCP Today
• ソースコード
• 問題
• MIT ライセンス