Browse Together MCP

🚀 瀏覽器代理服務與MCP服務器

本項目可讓你在桌面上運行 Playwright 瀏覽器和 MCP 服務器。你能啟動有頭瀏覽器供人類交互使用，同時配套的 MCP 服務器可通過 HTTP API 或自身來控制瀏覽器。它提供了兩個互補的服務，用於瀏覽器自動化和協同瀏覽：

• 瀏覽器代理服務：藉助 HTTP 控制一個持久的 Playwright 瀏覽器實例，你能像平常一樣登錄使用的服務。
• MCP 服務器：通過 FastMCP 框架將瀏覽器功能暴露給 MCP 客戶端（如 Claude Desktop），可在你提供的認證會話中運行，讓 MCP 命令擁有更多權限和用途。

這兩個服務均使用 Deno 和 TypeScript 構建，且能無縫協作。

🚀 快速開始

開發步驟

• 運行瀏覽器代理：deno task browser
• 運行 MCP 服務器：deno task mcp
• 格式化代碼：deno fmt
• 檢查依賴項：deno check --all browser.ts mcp.ts types.ts

✨ 主要特性

• 多瀏覽器支持：支持 Chromium（默認）或 Firefox。
• 持久瀏覽器會話：一個瀏覽器實例在其服務生命週期內一直運行。
• 頁面管理：列出所有活躍的瀏覽器頁面並關閉特定頁面。
• 內容操作：填寫表單字段、點擊元素、獲取頁面 HTML 內容和執行瀏覽器上下文中的 fetch 請求。

📚 詳細文檔

此項目通過一系列文檔描述了增量規劃步驟：

• 初始設計決策（注意：項目結構描述可能已過時）
• 瀏覽器代理服務概述（多會話 - 歷史）
• 單會話架構重構
• 類型安全計劃（Zod）
• 頁面彈性計劃
• 使用的庫
• 測試策略
• 配置
• 安全考慮
• Deno 最佳實踐
• MCP 服務器實現計劃
• FastMCP 重構

其中一些步驟可能已過時或不再相關，但作為參考和了解項目是如何構建的而被包含。

更多關於我們的本地沙迪（Sandy）猶他州振動編碼小組的信息，請訪問 vibe-coders.org。

🔧 技術細節

架構

+----------------+      +--------------+      +------------------+
|                |      |              |      |                  |
| Cline/LLM      | ---- | MCP Server   | ---- | Browser Service  |
| (MCP 客戶端)   |      | (mcp.ts)     | HTTP | (browser.ts)     |
|                |      |              |      |                  |
+----------------+      +--------------+      +------------------+
                               |                       |
                          FastMCP API            Playwright API
                               |                       |
                           標準輸入/輸出流       Chromium 瀏覽器

系統工作原理如下：

1. 瀏覽器服務（browser.ts）使用 Playwright 管理一個持久的 Chromium 瀏覽器實例。
2. MCP 服務器（mcp.ts）提供標準 MCP 接口，使用 FastMCP。
3. MCP 服務器通過 HTTP 將命令轉發到瀏覽器服務。
4. MCP 客戶端 如 Claude Desktop 可以通過簡單的工具調用來使用所有瀏覽器功能。