Lcbro MCP

🚀 LCBro

LCBroは、PlaywrightとChrome DevTools Protocol (CDP) の両方をサポートする強力なブラウザ自動化用のMCPサーバーです。インテリジェントな前処理、包括的なロギング、およびリモートブラウザ管理機能を提供します。

🚀 クイックスタート

npxを使った利用（推奨 - インストール不要）

# インストールせずに直接利用
npx lcbro

# カスタム設定で利用
npx lcbro --config /path/to/config.yaml --port 3000

グローバルインストール

# npmを通じてグローバルにインストール
npm install -g lcbro

# サーバーを起動
lcbro

ローカル開発

# クローンしてインストール
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"]
    }
  }
}

📦 インストール

前提条件

• 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

# Playwrightブラウザをインストール
npm run install:browsers

📚 ドキュメント

• インテリジェント前処理 - 自動データクリーニングと最適化
• LLMロギングガイド - 包括的なロギングシステム
• CDPブラウザサポート - Chrome DevTools Protocol統合
• リモートCDPサポート - リモートブラウザ管理
• ログディレクトリ設定 - ログ管理の設定

🎯 利用可能な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前処理でコンテンツを分析する

🏆 プロジェクトの状態

✅ 本番環境での使用可能 - すべての機能が実装され、テストされています
✅ npmパッケージ利用可能 - npmを通じてグローバルにインストールできます
✅ CLIインターフェース - 完全なコマンドラインインターフェースが利用可能です
✅ ドキュメント - 包括的なドキュメントが提供されています
✅ 多言語サポート - 英語、ロシア語、ポルトガル語
✅ 破壊的変更なし - すべての元の機能が保持されています
✅ 継続的インテグレーション - 自動テストとデプロイ
✅ Dockerサポート - マルチステージビルドとコンテナテスト
✅ セキュリティスキャン - 自動脆弱性検出

🔧 設定

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設定

# ローカルLLM（推奨）

#### 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

# 特定のポートで起動
lcbro --port 3001

# CDPサポートで起動
lcbro --cdp-enabled

# カスタム設定ファイルで起動
lcbro --config /path/to/config.yaml

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"]
    }
  }
}

# CDPサポート付き
{
  "mcpServers": {
    "lcbro": {
      "command": "npx",
      "args": ["-y", "lcbro", "--cdp-enabled"]
    }
  }
}

# カスタム設定付き
{
  "mcpServers": {
    "lcbro": {
      "command": "npx",
      "args": ["-y", "lcbro", "--config", "/path/to/config.yaml"]
    }
  }
}

🛠️ 高度な機能

インテリジェント前処理

LCBroは、LLMにデータを送信する前に自動的にデータをクリーニングし、最適化します。

# インテリジェント前処理を有効にする
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

📊 パフォーマンスと仕様

🔧 CI/CDパイプラインの状態

自動テストとデプロイ 🚀

パイプライン	状態	説明
CI/CD		メインのビルド、テスト、およびデプロイパイプライン
Docker		コンテナビルドとマルチプラットフォームテスト
リリース		自動リリースとnpm公開
ナイトリーテスト		拡張テストとパフォーマンスベンチマーク

📊 品質メトリクス

• テストカバレッジ: >80% (ユニット + E2E)
• ビルド時間: ~3 - 5分
• Dockerビルド: レイヤーキャッシュ付きのマルチステージ
• セキュリティ: CodeQL分析 + 依存関係スキャン

📋 すべてのワークフローを表示 → | 🚀 パイプラインの実行を表示 →

🛠️ 開発

前提条件

npm install
npm run install:browsers

ビルドとテスト

# プロジェクトをビルド
npm run build

# テストを実行
npm test

# E2Eテストを実行
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. プルリクエストを作成する

📞 サポートとコミュニティ

• 🐛 バグレポート: GitHub Issues
• 💬 ディスカッション: GitHub Discussions
• 📚 ドキュメント: 完全なドキュメント
• 💡 使用例: 使用例
• 🔧 CI/CDワークフロー: ワークフロードキュメント
• 🚀 パイプラインの状態: GitHub Actions
• 🛡️ セキュリティレポート: セキュリティタブ
• ⭐ スターをつける: リポジトリにスターをつけて成長を支援してください！

🙏 謝辞

• Playwright - ブラウザ自動化フレームワーク
• Chrome DevTools Protocol - リモートブラウザデバッグ
• MCP SDK - モデルコンテキストプロトコルフレームワーク
• Claude Desktop - MCPクライアント統合
• Cursor IDE - 開発環境

❤️ LCBroチームによって作成されました

LCBro - Low Cost Browser Remote Operations
バージョン: 1.0.10 • 状態: ✅ 本番環境での使用可能 • ライセンス: MIT

⬆ ページ上部に戻る