newton-browser

Newton Browser

Newton Browser は、エージェント向けのローカルな MCP ブラウザー制御製品です。セッションごとに分離された Chrome または Edge プロセスを起動し、継承したプライベート CDP パイプ経由で制御します。 デフォルトでは、ブラウザーの通信に Chromium の通常のネットワーク機能を使用し、Newton のプロキシ、オリジン許可リスト、リクエストのインターセプト、リソースのフィルタリングは使用しません。

デフォルトのランタイムでは、ブラウザー拡張機能、リレー、デーモン、デバッグ用 TCP ポート、データベース、テレメトリー、ホステッドサービス、モデルプロバイダーとの連携は必要ありません。

ステータス

デフォルトのソースランタイムでは、新しい共有エンジンが使用されるようになりました。共有 Newton ログインソースから分離されたワーカーを起動し、オプションで既存ブラウザー用の薄いアダプターを利用できます。ネイティブ操作、精密な編集、コンテキストに応じたコントロール、記録／ドキュメント、スクリーンショット、タブの所有権、更新の基盤を実装済みです。これは未リリースの開発チェックポイントであり、実環境での受け入れが完了した状態ではありません。

レガシーの直接ランタイムは廃止されました（2026-09-25）。セッションエンジンが操作、レシート、参照元の唯一の権限です。ビルド、型チェック、境界リント、全テストスイートはすべて成功します。フィードバック／読み取り機能の改良、プラットフォームと認証が必要なタスクの QA、および変更されていない 3 つのパッケージ済みリリースゲートは未完了です。現在の進捗台帳、残りのロードマップ、統合記録を参照してください。

バージョン 0.7.2 は GitHub のプレリリース tarball として公開されており、macOS Chrome で検証済みです。このバージョンの Windows および Linux のレシートは未確認です。npm またはブラウザーストアでのリリースはありません。

Newton が実装するのは、ステートレスな MCP 2026-07-28 のみで、改行区切りの stdio JSON を使用します。 クライアントは、すべてのリクエストにプロトコルバージョンと機能を含めます。Newton はレガシーのハンドシェイクやフレーミングモードを公開しません。

要件

• Node.js 24 以降。
• 最新のローカル Chrome または Edge のインストール。
• MCP 2026-07-28、ローカル stdio サーバー、画像コンテンツに対応した MCP クライアント。

ビルドと接続

pnpm install --frozen-lockfile
pnpm build
node apps/mcp-server/dist/index.js doctor --live

一時的なセッションにはこれだけで十分です。Newton は Chrome または Edge を検出し、セッションごとに新しい分離済み ID を作成します。オプションのセットアップでは、デフォルトのブラウザーだけを選択します。

node apps/mcp-server/dist/index.js setup --browser chrome

所有するすべてのセッションは、共有ログインソースの分離されたコピーです（セッションで別のソースを指定しない限り、default が使われます）。以降のセッションで使うために一度だけサインインするには、ソースの可視ブラウザーを開き、ご自身でサインインしてから確認します。

node apps/mcp-server/dist/index.js source login --id default --browser chrome

Newton がエージェントに認証情報の入力や取得を求めることはありません。公開されたサインイン情報がソースの次世代となり、実行中のセッションはそれぞれ独自のコピーを保持します。セッションで行った操作がソースに統合されることはありません。

MCP 設定

{
  "mcpServers": {
    "newton-browser": {
      "command": "node",
      "args": ["C:\\absolute\\path\\newton-browser\\apps\\mcp-server\\dist\\index.js"]
    }
  }
}

ローカルインストーラーを使うと、Codex の設定を更新するか、汎用エントリーを出力できます。

node apps/mcp-server/dist/index.js install codex --dry-run
node apps/mcp-server/dist/index.js install generic

Codex のインストールでは、Codex の mcp_2026_07_28 機能を有効にし、CODEX_MCP_PROTOCOL_VERSION=2026-07-28 を固定したうえで、対象候補のステートレスな検出機能が実際に動作すること、自己申告されたパッケージバージョン、必須のブラウザーツールカタログを検証してから、設定をアトミックに置き換えます。結果として得られるエントリーポイントとバージョンの組み合わせは固定されます。互換性のない候補や古い候補が、動作中のインストールに取って代わることはありません。

エージェントのワークフロー

ツール（tools/list が正とします）：browser.session.start、browser.observe、 browser.act、browser.command、browser.document.read、browser.document.continue、 browser.screenshot、browser.console、browser.network、browser.pages.list、 browser.page.select、browser.sessions.list、browser.session.stop、および オペレーターが選択する既存ブラウザー用ツール browser.existing.discover と browser.existing.setup。

通常のループ：

1. 完全な URL を指定して browser.session.start を実行すると、セッションと最初のページ、 および nextCommandId が返されます。
2. browser.observe は参照 ID 付きの、範囲を限定したコントロールを返します。レコード モードではリンク、テーブル、フォームを読み取り、browser.document.read では 続きを読み取るためのカーソル付きでテキストを読み取ります。
3. browser.act は型指定されたアクションを 1 つ、または一連のアクションを実行し、実行結果を返します。実行結果には、ディスパッチ、事後条件、状態が変わった場合は次の状態が含まれます。commandId は同一のコマンドに限って再利用してください。実行結果が不確かな場合は、再実行せずに browser.command で状態を確認してください。
4. browser.session.stop はキューとは独立してセッションを終了します。

ポップアップや新しいタブは、選択中のページを変更せずにセッションのページとして追加されます。 browser.pages.list と browser.page.select でページ間を移動できます。応答しなくなったレンダラーは 同じページ上で再起動され、そのことが実行結果に示されます。コンソールとネットワークの記録は、 有効化したことがページから見えるため、オプトイン方式です。

ID と不透明なプロファイルのインポート

ID はストア内の不透明なブラウザープロファイルであり、ログインソースとセッションの複製は これを基に作成されます。オペレーター向けユーティリティ：

newton-browser identity create --browser chrome
newton-browser identity list
newton-browser identity lease-inspect --id nbi_<opaque-id>
newton-browser identity lease-recover --id nbi_<opaque-id>
newton-browser identity delete --id nbi_<opaque-id>
newton-browser identity import --browser chrome `
  --user-data-root "C:\path\to\User Data" `
  --profile-directory Default

インポートでは、閉じられた安定したローカルプロファイルから、認証情報を含むファイルのうち 限定的な許可リストに含まれるものだけをバイト単位でコピーし、ソースは変更しません。 パスワード、自動入力、履歴、ダウンロード、拡張機能、セッション、サービスワーカー、 キャッシュは対象外です。ブラウザーの暗号化により、コピーした認証情報を引き続き使用できない 場合があります。Newton がその保護を回避することはありません。

セキュリティ境界

• ブラウザーは継承されたプライベート CDP パイプ上で動作します。所有モードでは、デバッグポート、リレー、拡張機能は使用しません。
• ホスティングプロセスは、所有するブラウザーの接続先をパブリックインターネットアドレスに制限できます（NEWTON_BROWSER_EGRESS=public）。それ以外の場合、ネットワーク通信は通常の Chromium のネットワーク通信です。
• ページのコンテンツは信頼できないデータです。エフェクトを許可したり、ローカルファイルを選択したりすることはできません。
• スクリーンショットでは、フレームやシャドウルート内のパスワードフィールドと機密性の高いオートコンプリートフィールドに加え、明示的に指定された機密領域もマスクされます。
• ネットワークのレスポンス本文を取得できるのは、ページ自身のオリジンからの、長さを制限したテキストに限られます。ヘッダーは保持されません。

セキュリティ、プライバシー、MCP クライアントを参照してください。

開発とリリース

pnpm build
pnpm lint
pnpm typecheck
pnpm test
pnpm eval
pnpm eval:agent-cost
pnpm pack:check
pnpm eval:real-sites
pnpm release:check

必要なブラウザー／プラットフォームごとに、pnpm eval:real-sites を 1 回実行してください。 リリースには、正確にパッケージ化された候補から Windows と Linux で連続 3 回、 重大なテストをスキップせずに pnpm release:check に合格することに加え、 固定された Linux Chrome for Testing のマトリックスと一致するクロスプラットフォームの tarball ハッシュが必要です。

リポジトリの構成

apps/mcp-server/      stateless stdio MCP host and owned-browser runtime
packages/core/        schemas, redaction, provenance, and safety policy
packages/driver/      strict TypeScript CDP driver
scripts/              builds, release checks, and live harnesses
skills/newton-browser agent operating guidance
test/                 fixtures, regressions, and bounded evidence

ライセンス

ソースは MIT ライセンスの下でライセンスされています。Newton Browser のリリースの 公開または配布は、これとは別の、メンテナーが管理する作業です。