Runbook Ai MCP

🚀 Runbook AI MCP Server

このMCP（Model Context Protocol）サーバーは、Chrome拡張機能を通じてブラウザーの自動化機能を提供します。Claude Code のようなターミナルベースのエージェントが、実際のブラウザーセッションを通じて任意のWebサイトと対話できるようになります。

Runbook AI エコシステムの一部です。フィードバックを提供し、開発に参加するには、Discordコミュニティ に参加してください！

https://github.com/user-attachments/assets/a43fba64-bc40-4ef6-9840-e100203e2cf5

🚀 クイックスタート

Runbook AI MCP Serverは、Chrome拡張機能を通じてブラウザー自動化機能を提供し、ターミナルベースのエージェントがWebサイトと対話できるようにします。以下の手順でセットアップして利用できます。

✨ 主な機能

ほとんどのブラウザーベースのMCPツール（chrome-devtools-mcp など）は、すべてのブラウザーアクションの後に完全なDOMを送信することで、LLMのコンテキストウィンドウを圧迫します。

Runbook AIは異なります。

• 最適化されたコンテキスト：高度に簡略化されたHTMLバージョンを生成します。不要な部分を削除し、必要なテキストとインタラクション要素を保持します。コンパクトで高速で、トークンを消費しません。
• 万能の解決策：ExpediaやLinkedIn、内部ツールなど、専用のMCPサーバーがないサイトにも最適です。
• プライバシー重視：すべてブラウザー内で実行されます。選択したLLMプロバイダーへのリモート呼び出し以外はありません。eval() や怪しいスクリプトは使用されません（Chrome拡張機能のサンドボックスによって強制されます）。
• 効率的なナビゲーション：簡略化されたHTMLはビューポートを超えているため、スクロールやマルチページタスクがはるかに効率的になります。

📦 インストール

MCPサーバー

MCP設定構成に以下を追加します。

{
  "mcpServers": {
    "runbook-ai": {
      "command": "npx",
      "args": ["-y", "runbook-ai-mcp@latest"]
    }
  }
}

Chrome拡張機能

Runbook AI 拡張機能をChromeウェブストアからインストールします。

拡張機能のサイドパネルから開いた拡張機能設定でMCPを有効にします。

LLMのAPIキー、モデル名、ベースURLを設定します。Gemini 3 Flash（gemini-3-flash-preview）の使用をおすすめします。Google AI Studio から無料のAPIキーを取得できます。

デフォルトでは、拡張機能はすべてのWebサイトにアクセスできます。アクセスを制限する場合は、Chrome拡張機能の詳細に移動し、サイトアクセス設定に個々のサイトを追加します。

💻 使用例

基本的な使用法

Chromeを開き、拡張機能のサイドパネルを開いたままにします。

MCPサーバーを起動します（MCPクライアントによって呼び出されると自動的に起動します）。

ツールスキーマ

サーバーは単一のツールを公開しています。

browser-agent

AIと自動化機能を使ってChromeブラウザーでタスクを実行します。

パラメーター：

• prompt（文字列、必須）：AIエージェントが実行するタスクのプロンプト

例：

{
  "name": "browser-agent",
  "arguments": {
    "prompt": "Go to google.com and search for 'MCP protocol'"
  }
}

🔧 技術詳細

開発

# 依存関係のインストール
npm install

# ビルド
npm run build

# 開発モードで実行
npm run dev

# テストを実行
npm test

アーキテクチャ

1. MCPサーバー：stdioを介してMCPクライアントと通信します。
2. WebSocketサーバー：ポート9003でChrome拡張機能の接続を待機します。
3. Chrome拡張機能：ブラウザーの自動化タスクを実行します。

ツールが呼び出されるとき：

1. MCPクライアントがstdioを介してMCPサーバーにリクエストを送信します。
2. MCPサーバーがWebSocketを介してリクエストをChrome拡張機能に転送します。
3. 拡張機能がタスクを実行し、結果を返します。
4. 結果がMCPクライアントに送信されます。

🤝 コントリビューション

コントリビューションは大歓迎です！自由にPRを送ってください。