mcpField
R
Reticle

Reticle

ローカル
reticle.sh開発ツール1.3k今日更新
リポジトリ公式サイト

Reticle について

Reticleのブリッジ兼MCPサーバーで、コーディングエージェントが実行中のWebアプリを調べられます。アプリはブラウザーSDKでローカルWebSocketエンドポイントに接続し、エージェントは状態の確認や操作、検証を行います。

主な機能

  1. 01アプリ向けローカルWebSocketブリッジ
  2. 02ナビゲーション、観察、操作のツール
  3. 03アサーションと操作後の待機判定
  4. 04非公開ツールを名前で呼び出し
  5. 05全ツール公開のオプション

活用シーン

  1. 01実行中アプリのページ状態を確認
  2. 02操作を行いアプリの応答を観察
  3. 03アプリの動作に対するアサーション

MCP 対応

stdio経由でMCPツールを公開し、ローカルブリッジを自動起動します。アプリの`@reticlehq/browser` SDKがそのブリッジに接続します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "reticlehq-reticle": {
      "command": "npx",
      "args": [
        "-y",
        "@reticlehq/server"
      ]
    }
  }
}
起動コマンドnpx -y @reticlehq/server

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@reticlehq/server3.8.2

ツール

10

掲載時のツール一覧 · 1 日前に更新

パラメーター型必須説明
urlstringいいえ移動先の URL。
hardbooleanいいえreload:true の場合、ブラウザーキャッシュを回避します（Cmd+Shift+R）。
reloadbooleanいいえ別のページに移動せず、現在のページを再読み込みします（以前の独立した更新ツールに代わるものです）。
sessionIdstringいいえ特定のタブを対象にします。対象を指定する場合以外は省略してください。手順を参照してください。
timeout_msintegerいいえページが復帰するまで待つ時間です（SDK が新しい URL で再接続するか、再読み込み時に同じ ID で再接続します）。タイムアウト後に confirmed:false を返します。

詳細

@reticlehq/server

Reticle のブリッジおよび MCP サーバーです。アプリの @reticlehq/browser SDK が接続する localhost の WebSocket エンドポイントをホストし、コーディングエージェントがライブアプリを確認、操作、観察し、アサーションを実行するための MCP ツールを公開します。

npx @reticlehq/server init   # wire the project: SDK + build plugin + MCP registration
npx @reticlehq/server mcp    # MCP over stdio; auto-starts the bridge on ws://localhost:4400

このパッケージをインストールすると reticle バイナリが利用できるため、プロジェクト内では reticle mcp と npx @reticlehq/server mcp は同じコマンドです。reticle は npm のパッケージ名ではありません。

エージェントから接続してください。Claude Code では、ユーザースコープに登録します。

claude mcp add reticle -s user -- npx @reticlehq/server mcp

デフォルトのツール（10 個）：

reticle_navigate、reticle_look、reticle_act、reticle_act_and_wait、reticle_observe、reticle_assert、reticle_session、reticle_tools、reticle_run、reticle_verify。

判定結果を返すのは reticle_act_and_wait と reticle_assert のみです。それ以外はアプリを操作するか、アプリの情報を読み取ります。

1 ターンあたりのツールのペイロードを小さく保つため、ほかにもツールが用意されていますが、公開されていません。スクリーンショットやビジュアル差分、保存済みフロー、記録、ベースライン、時計制御、ビューポート、クロール、カバレッジ、ネットワークのモック、リースなどが含まれます。reticle_run で名前を指定して利用するか、reticle_tools で一覧表示するか、RETICLE_ADVERTISE_ALL_TOOLS=1 で全ツールを公開できます（この場合、1 ターンあたりのツールのペイロードはおよそ 2 倍になります）。

メインの README を参照してください。

ライセンス

FSL-1.1-ALv2（ソース公開型：Reticle 自体の再販売を除き、あらゆる用途で無料で利用できます。2 年後に Apache-2.0 に移行します）。dist/features/ee/ 内のファイルは、Reticle Enterprise License の対象となるエンタープライズ機能です。開発、テスト、評価には無料で利用でき、本番環境ではライセンスキーを有効化する必要があります。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。