Runbook Ai MCP

🚀 Runbook AI MCP Server

Runbook AI MCP Server 是一個 MCP（模型上下文協議）服務器，它通過 Chrome 擴展程序提供瀏覽器自動化功能。它允許像 Claude Code 這樣基於終端的代理通過你的即時瀏覽器會話與任何網站進行交互。

它是 Runbook AI 生態系統的一部分。加入 Discord 社區 提供反饋並參與開發！

點擊查看相關視頻

🚀 快速開始

要開始使用 Runbook AI MCP Server，你需要完成 MCP 服務器和 Chrome 擴展程序的安裝，並進行相應的設置。

✨ 主要特性

大多數基於瀏覽器的 MCP 工具（如 chrome-devtools-mcp）會在每次瀏覽器操作後發送整個 DOM，從而佔用大量的大語言模型上下文窗口。而 Runbook AI 與眾不同：

• 優化上下文：它生成高度簡化的 HTML 版本，去除無用信息，同時保留關鍵文本和交互元素。這種簡化的 HTML 緊湊、快速，不會消耗過多的令牌。
• 通用解決方案：如果某個網站沒有專門的 MCP 服務器（如 Expedia、LinkedIn 或內部工具），Runbook AI 可以完美填補這一空白。
• 隱私至上：它完全在你的瀏覽器中運行，除了與你選擇的大語言模型提供商進行遠程調用外，不進行其他遠程調用。並且不使用 eval() 或可疑腳本（由 Chrome 擴展程序沙箱強制執行）。
• 高效導航：簡化後的 HTML 超越了視口範圍，使滾動和多頁面任務更加高效。

📦 安裝指南

MCP 服務器

將以下內容添加到你的 MCP 設置配置中：

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

Chrome 擴展程序

1. 從 Chrome 網上應用店安裝 Runbook AI 擴展程序。
2. 從擴展程序側邊欄打開擴展程序設置，啟用 MCP。
3. 設置大語言模型 API 密鑰、模型名稱和基礎 URL。建議使用 Gemini 3 Flash（gemini-3-flash-preview）。你可以從 Google AI Studio 獲取免費的 API 密鑰。
4. 默認情況下，擴展程序可以訪問 所有 網站。如果你想限制訪問範圍，可以轉到 Chrome 擴展程序詳細信息，在“站點訪問”設置中添加單個站點。

💻 使用示例

基礎用法

1. 打開 Chrome 瀏覽器，並保持擴展程序側邊欄打開。
2. 啟動 MCP 服務器（當 MCP 客戶端調用時，它將自動啟動）。

工具調用示例

服務器公開了一個工具：browser-agent，用於在 Chrome 瀏覽器中運行具有人工智能和自動化功能的任務。

參數：

• prompt（字符串，必需）：供人工智能代理執行的任務提示

示例：

{
  "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 服務器：通過標準輸入輸出與 MCP 客戶端進行通信。
2. WebSocket 服務器：在端口 9003 監聽 Chrome 擴展程序的連接。
3. Chrome 擴展程序：執行瀏覽器自動化任務。

當調用工具時：

1. MCP 客戶端通過標準輸入輸出向 MCP 服務器發送請求。
2. MCP 服務器通過 WebSocket 將請求轉發給 Chrome 擴展程序。
3. 擴展程序執行任務並返回結果。
4. 結果被髮送回 MCP 客戶端。

🤝 貢獻

歡迎貢獻代碼！請隨時提交拉取請求。