Rdvo MCP Server

🚀 鉄の傀儡モデルコンテキストプロトコルサーバー

このサーバーは、PuppeteerとSteelが提供するブラウザ自動化機能を利用したモデルコンテキストプロトコルサーバーです。LLMがWebページとのインタラクション、スクリーンショットの取得、JavaScriptコードの実行を可能にし、リアルなブラウザ環境を提供します。

🚀 クイックスタート

このサーバーを使用するには、以下の手順に従ってください。

1. 依存関係のインストール：

   npm install
   

2. プロジェクトのビルド：

   npm run build
   

3. サーバーの起動：

   npm start
   

4. Claudeデスクトップアプリケーションを開き、使用を開始します！

デフォルトでは、サーバーはポート3000でリクエストを待機します。

✨ 主な機能

• Puppeteerを使用したブラウザ自動化操作をサポート
• 強力なコンソール機能を提供し、Webページとのインタラクションを可能に
• 複数のスクロール動作とブロック位置決めをサポート
• Steelプロトコルを統合し、モデルコンテキストのインタラクションを可能に
• カスタムユーザーエージェント文字列のサポート
• 詳細なログ記録とデバッグオプションを提供

📦 インストール

上記のクイックスタートの手順に従って、依存関係のインストール、プロジェクトのビルド、サーバーの起動を行ってください。

📚 ドキュメント

コンポーネント

ツール

• puppeteer_navigate

  • ブラウザで任意のURLにナビゲートします。
  • 入力：
    • url (文字列、必須)：ナビゲートするURL
    • timeout (数値、オプション、デフォルト値：60000)：ナビゲートのタイムアウト時間（ミリ秒）
    • waitUntil (文字列、オプション、デフォルト値："domcontentloaded")：ナビゲートが成功したと見なす条件。オプション："load"、"domcontentloaded"、"networkidle0"、"networkidle2"

• puppeteer_screenshot

  • ページ全体または特定の要素のスクリーンショットを取得します。
  • 入力：
    • name (文字列、必須)：スクリーンショットの名前
    • selector (文字列、オプション)：特定の要素を取得するためのCSSセレクター

• puppeteer_click

  • ページ上の要素をクリックします。
  • 入力：selector (文字列、必須)：クリックする要素のCSSセレクター

• puppeteer_fill

  • フォームフィールドに値を入力します。
  • 入力：
    • selector (文字列、必須)：フォームフィールドのCSSセレクター
    • value (文字列、必須)：入力する値

• puppeteer_select

  • SELECTタグ内の要素を選択します。
  • 入力：
    • selector (文字列、必須)：選択する要素のCSSセレクター
    • value (文字列、必須)：選択する値

• puppeteer_hover

  • ページ上の要素にマウスをホバーします。
  • 入力：selector (文字列、必須)：ホバーする要素のCSSセレクター

• puppeteer_evaluate

  • ブラウザコンソールでJavaScriptコードを実行します。
  • 入力：script (文字列、必須)：実行するJavaScriptスクリプト

• puppeteer_get_content

  • 現在のページからコンテンツを抽出します。
  • 入力：selector (文字列、オプション)：特定の要素からコンテンツを取得するためのCSSセレクター。指定しない場合は、ページ全体のコンテンツが返されます。

• puppeteer_scroll

  • ページをスクロールして遅延ロードをトリガーします。
  • 入力：
    • behavior (文字列、オプション、デフォルト値："auto")：スクロール動作（"auto" または "smooth"）
    • block (文字列、オプション、デフォルト値："start")：スクロールブロック（"start"、"end"、"nearest"、"center"）

リソース

• ページ
  • 現在のWebページへのアクセスを提供します。
• スクリーンショット
  • スクリーンショットデータを返します。
• タイトル
  • 現在のページのタイトルを返します。
• コンテンツ
  • 現在のページのコンテンツを返します。
• cookies
  • 現在のページのCookieを取得または設定します。

詳細な設定

環境変数

サーバーを実行するために必要な主要な環境変数は以下の通りです。

• NODE_ENV：本番モードを有効にするには "production" に設定します。デフォルト値："development"
• PORT：サーバーがリッスンするポートを指定します。範囲は1024から65535。デフォルト値：3000
• PUPPETEER_WS_ENDPOINT：Puppeteer WebSocketエンドポイントを指定します。デフォルト値：ws://localhost:3000/ws/puppeteer
• STEEL_API_KEY：認証に使用するSteel APIキー
• STEEL_SERVER_URL：SteelサービスのURL。デフォルト値：http://localhost:8080

サーバー設定

サーバーの動作をカスタマイズするには、以下の設定オプションを編集してください。

{
  "puppeteer": {
    "defaultViewport": { // デフォルトのビューポート設定
      "width": 1920,
      "height": 1080,
      "deviceScaleFactor": 1,
      "isLandscape": true,
      "hasTouch": false,
      "isMobile": false
    },
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.126 Safari/537.36" // カスタムユーザーエージェント文字列
  },
  "steel": {
    "apiEndpoint": "http://localhost:8080", // Steel APIエンドポイント
    "timeout": 30000, // リクエストのタイムアウト時間（ミリ秒）
    "proxyEnabled": true, // プロキシを有効にするかどうか
    "proxyUrl": "http://localhost:8081" // プロキシサーバーのURL
  },
  "logging": {
    "enabled": true, // ログ記録を有効にするかどうか
    "level": "info", // ログレベル："debug"、"info"、"warn"、"error"
    "outputFile": "./logs/server.log" // ログ出力ファイルのパス
  }
}

🔧 技術詳細

トラブルシューティング

• Puppeteerに問題が発生した場合は、システムに必要なすべての依存関係がインストールされていることを確認してください。詳細については、Puppeteerトラブルシューティングガイドを参照してください。
• Steelクラウドサービスを使用する場合は、APIキーが有効で必要な権限を持っていることを確認してください。
• ローカルのSteelインスタンスを使用する場合は、それが実行中で、指定されたURL（カスタムの場合）またはデフォルトのローカルアドレスにアクセス可能であることを確認してください。

より詳細な設定オプションと高度な使用方法については、SteelドキュメントとPuppeteer APIリファレンス資料を参照してください。