Lcbro MCP

🚀 LCBro

LCBro 是一款強大的瀏覽器自動化 MCP 服務器，支持 Playwright 和 Chrome DevTools Protocol (CDP)。它提供智能預處理、全面的日誌記錄和遠程瀏覽器管理功能，專注於優化 LLM 請求成本，減少上下文使用。

🚀 快速開始

選項 1：使用 npx（推薦 - 無需安裝）

# 直接使用，無需安裝
npx lcbro --help

# 啟動服務器
npx lcbro

# 啟用 CDP 支持
npx lcbro --cdp-enabled

選項 2：全局安裝

# 通過 npm 全局安裝
npm install -g lcbro

# 驗證安裝
lcbro --version

# 啟動服務器
lcbro

配置 MCP 客戶端

// Claude Desktop: ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "lcbro": {
      "command": "npx",
      "args": ["-y", "lcbro"]
    }
  }
}

// Cursor IDE: ~/.cursor/mcp.json
{
  "mcpServers": {
    "lcbro": {
      "command": "npx",
      "args": ["-y", "lcbro"]
    }
  }
}

✨ 主要特性

🎯 瀏覽器自動化

• 通過 JavaScript 執行實現真實瀏覽器控制
• 支持登錄流程、點擊、文本輸入、表單處理
• 支持截圖捕獲和內容提取
• 具有持久上下文的會話管理

🤖 智能預處理

• 自動生成預處理提示
• 集成本地 LLM（Ollama、JAN）
• 智能內容分析和優化
• 經濟高效的數據準備

🔧 多引擎支持

• Playwright：功能齊全的自動化
• CDP：支持 Chrome DevTools Protocol
• 遠程瀏覽器連接
• 自動檢測和回退

📊 高級日誌記錄

• 全面的 LLM 交互日誌
• 性能指標和令牌跟蹤
• 可配置的日誌輪換和壓縮
• 調試和監控功能

📦 安裝指南

先決條件

• Node.js 18+
• npm 或 yarn
• Chrome/Chromium 瀏覽器（用於 CDP 支持）

全局安裝（推薦）

# 全局安裝
npm install -g lcbro

# 驗證安裝
lcbro --version

本地開發

# 克隆並安裝
git clone https://github.com/lcbro/lcbro.git
cd lcbro
npm install
npm run build
npm start

Docker

# 使用 Docker 運行
docker run -p 3000:3000 lcbro:latest

💻 使用示例

基礎瀏覽器自動化

# 導航並提取內容
npx lcbro navigate --url "https://example.com"
npx lcbro extract --format text

自定義配置

# 啟用 CDP 支持
npx lcbro --cdp-enabled --port 3001

# 自定義日誌目錄
npx lcbro --logs-dir "/custom/logs" --log-level debug

MCP 客戶端集成

{
  "mcpServers": {
    "lcbro": {
      "command": "npx",
      "args": ["-y", "lcbro"]
    }
  }
}

📚 詳細文檔

• 智能預處理 - 自動數據清理和優化
• LLM 日誌記錄指南 - 全面的日誌記錄系統
• CDP 瀏覽器支持 - Chrome DevTools Protocol 集成
• 遠程 CDP 支持 - 遠程瀏覽器管理
• 日誌目錄配置 - 日誌管理設置

🔧 技術細節

配置

LCBro 使用 YAML 配置文件，並支持 CLI 覆蓋。可以創建 config/default.yaml 文件或使用 CLI 選項：

基本配置

server:
  host: "localhost"
  port: 3000

browser:
  engine: playwright  # playwright | cdp
  headless: true
  defaultTimeoutMs: 30000
  maxContexts: 8
  storageDir: /data/profiles

llm:
  defaultModel: "ollama:llama3.1"
  maxOutputTokens: 2000
  temperature: 0
  host: "localhost"
  port: 11434
  janPort: 1337
  autoPreprocess: true

security:
  allowDomains: ["example.com", "gov.br"]
  blockPrivateNetworks: true

CLI 配置覆蓋

# 服務器設置
lcbro --port 3001 --host 0.0.0.0

# CDP 瀏覽器支持
lcbro --cdp-enabled --cdp-port 9222

# 遠程 CDP 服務器
lcbro --remote-url https://cdp.example.com:9222 --remote-ssl-mode enabled

# 日誌配置
lcbro --log-level debug --logs-dir /tmp/lcbro-logs

CLI 使用

LCBro 提供了全面的命令行界面：

主要命令

# 啟動服務器
lcbro

# 顯示幫助
lcbro --help

# 顯示當前配置
lcbro config

# 使用 CDP 啟動瀏覽器
lcbro browser:launch -b chrome -p 9222

# 管理日誌文件
lcbro logs --command summary

# 測試遠程 CDP 連接
lcbro test:remote -u https://cdp.example.com:9222

環境變量

LCBro 支持通過環境變量進行配置：

LLM 配置

# 本地 LLMs（推薦）

#### Ollama（免費，無需 API 密鑰）
```bash
# 安裝 Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 拉取模型
ollama pull llama3.1

# 配置 LCBro
export LLM_HOST=localhost
export LLM_PORT=11434
export LLM_DEFAULT_MODEL=ollama:llama3.1

JAN AI（免費，可選 API 密鑰）

# 為 JAN AI 配置 LCBro
export LLM_HOST=localhost
export LLM_JAN_PORT=1337
export LLM_DEFAULT_MODEL=jan:llama-3.1-8b

外部 LLM API（可選）

# OpenAI
export OPENAI_API_KEY=your_api_key_here

# Anthropic
export ANTHROPIC_API_KEY=your_api_key_here

CDP 瀏覽器配置

# 啟用 CDP 支持
export BROWSER_ENGINE=cdp

# CDP 服務器設置
export CDP_HOST=localhost
export CDP_PORT=9222

# 遠程 CDP 服務器
export CDP_REMOTE_URL=https://cdp.example.com:9222
export CDP_REMOTE_SSL_MODE=enabled
export CDP_REMOTE_API_KEY=your_api_key

高級特性

智能預處理

LCBro 在將數據發送到 LLMs 之前會自動清理和優化數據：

# 啟用智能預處理
lcbro --auto-preprocess

# 配置預處理閾值
lcbro --preprocessing-threshold-html 5000
lcbro --preprocessing-threshold-text 8000

CDP 瀏覽器管理

# 使用 CDP 啟動瀏覽器
lcbro browser:launch -b chrome -p 9222 -n 3

# 連接到遠程 CDP 服務器
lcbro --remote-url https://cdp.example.com:9222

# 測試遠程連接
lcbro test:remote -u https://cdp.example.com:9222

日誌管理

# 查看日誌摘要
lcbro logs --command summary

# 清理舊日誌
lcbro logs --command cleanup --age 30

# 壓縮日誌文件
lcbro logs --command compress

MCP 工具

LCBro 提供以下 MCP 工具：

導航工具

• navigate_open - 在瀏覽器上下文中打開新 URL
• navigate_goto - 在現有上下文中導航到 URL

交互工具

• interact_click - 通過選擇器、文本或角色點擊元素
• interact_type - 在輸入字段中輸入文本
• interact_wait - 等待條件（選擇器、網絡空閒、URL 更改）

提取工具

• extract_content - 以各種格式提取頁面內容
• extract_table - 以 JSON 格式提取表格數據
• extract_attributes - 從元素中提取屬性
• extract_screenshot - 對頁面或元素進行截圖

會話工具

• session_auth - 執行身份驗證序列
• session_manage - 管理瀏覽器會話和上下文

LLM 工具

• llm_transform - 使用 LLM 和自定義指令轉換數據
• llm_analyze - 使用 LLM 預處理分析內容

📊 性能與規格

🔧 CI/CD 管道狀態

自動化測試與部署 🚀

管道	狀態	描述
CI/CD		主要構建、測試和部署管道
Docker		容器構建和多平臺測試
Release		自動發佈和 npm 發佈
Nightly		擴展測試和性能基準測試

質量指標

• 測試覆蓋率：>80%（單元 + 端到端）
• 構建時間：~3 - 5 分鐘
• Docker 構建：多階段構建，支持層緩存
• 安全性：CodeQL 分析 + 依賴掃描

📋 查看所有工作流 → | 🚀 查看管道運行 →

🛠️ 開發

先決條件

npm install
npm run install:browsers

構建與測試

# 構建項目
npm run build

# 運行測試
npm test

# 運行端到端測試
npm run test:e2e

# 在本地運行 CI 管道
make ci

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

🤝 貢獻

1. 分叉倉庫
2. 創建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開拉取請求

📞 支持與社區

• 🐛 Bug 報告：GitHub 問題
• 💬 討論：GitHub 討論
• 📚 文檔：完整文檔
• 💡 示例：使用示例
• 🔧 CI/CD 工作流：工作流文檔
• 🚀 管道狀態：GitHub 操作
• 🛡️ 安全報告：安全標籤
• ⭐ 給我們加星：通過給倉庫加星幫助我們成長！

🙏 致謝

• Playwright - 瀏覽器自動化框架
• Chrome DevTools Protocol - 遠程瀏覽器調試
• MCP SDK - 模型上下文協議框架
• Claude Desktop - MCP 客戶端集成
• Cursor IDE - 開發環境