Octo MCP

🚀 Octo Browser MCP Server

Octo Browser MCP Serverは、Octo Browser（マルチアカウント用のアンチディテクトブラウザ）用のMCP（Model Context Protocol）サーバーです。このサーバーにより、ClaudeなどのAIアシスタントが自然言語でOcto Browserのプロファイルを制御できます。

✨ 主な機能

• プロファイル管理：Octo Browserのプロファイルを起動、停止、一覧表示できます。
• 名前での検索：Cloud APIを使用して名前でプロファイルを検索できます（APIトークンが必要）。
• 一時的なプロファイル：使用後に削除される一時的なプロファイルを作成できます。
• ブラウザ自動化：CDPを介したPlaywrightベースの完全なブラウザ制御が可能です。
• スクリーンショットの取得：ページまたは要素のスクリーンショットを撮ることができます。
• マルチタブサポート：複数のブラウザタブを管理できます。
• Docker互換性：Dockerまたはリモートホストで実行されているOcto Browserと互換性があります。

📦 インストール

PyPIからのインストール

pip install octo-mcp

ソースからのインストール

git clone https://github.com/anthropics/octo-mcp.git
cd octo-mcp
pip install -e .

Playwrightのインストール

playwright install chromium

📚 ドキュメント

環境変数

APIトークンの取得方法

1. Octo Browserを開きます。
2. 設定 → APIに移動します。
3. APIトークンをコピーします。

APIトークンは名前でプロファイルを検索する場合にのみ必要です。基本的なプロファイル操作はトークンなしでも機能します。

💻 使用例

Claude Codeでの使用

MCPサーバーの追加

# 基本設定（ローカルAPIのみ）
claude mcp add octo-mcp -- python -m octo_mcp.server

# 認証付き（推奨）
claude mcp add octo-mcp \
  -e OCTO_USERNAME="your@email.com" \
  -e OCTO_PASSWORD="your_password" \
  -- python -m octo_mcp.server

# Cloud APIを使用した完全な設定（プロファイル名での検索を有効にする）
claude mcp add octo-mcp \
  -e OCTO_USERNAME="your@email.com" \
  -e OCTO_PASSWORD="your_password" \
  -e OCTO_API_TOKEN="your_api_token" \
  -- python -m octo_mcp.server

Claude Codeの再起動

MCPサーバーを追加した後、新しいツールを読み込むためにClaude Codeを再起動します。

利用可能なツール

プロファイル管理

プロファイル検索（APIトークンが必要）

ブラウザ接続

ナビゲーション

インタラクション

情報抽出

JavaScript

タブ管理

会話の例

ユーザー: プロファイル「work_account」を起動してgoogle.comに移動してください。

Claude: プロファイルを起動してGoogleに移動します。

[Uses octo_start_profile_by_name with name="work_account"]
Profile 'work_account' started.
ws_endpoint: ws://localhost:52341/devtools/browser/abc123

[Uses browser_connect with the ws_endpoint]
Connected to browser.

[Uses browser_navigate with url="https://google.com"]
Navigated to https://google.com

[Uses browser_screenshot]
[Shows screenshot of Google homepage]

プロファイルが起動し、Googleのホームページが表示されています。

Docker / リモート設定

Octo Browserが別のホスト（例：Docker内）で実行されている場合は、OCTO_HOST変数を設定します。

claude mcp add octo-mcp \
  -e OCTO_HOST="192.168.1.100" \
  -e OCTO_USERNAME="your@email.com" \
  -e OCTO_PASSWORD="your_password" \
  -- python -m octo_mcp.server

サーバーは自動的にWebSocketのURLを127.0.0.1から設定されたホストに書き換えます。

🔧 トラブルシューティング

"Octo Browser API unavailable"

Octo Browserが実行中であることを確認してください。アプリケーションを開くとローカルAPIが自動的に起動します。

"OCTO_API_TOKEN is not set"

このエラーは、APIトークンなしでocto_find_profile_by_nameまたはocto_search_profilesを使用した場合に表示されます。以下のいずれかを行ってください。

1. MCP設定にAPIトークンを追加します。
2. UUIDを使用してocto_start_profileを使用します（UUIDはOcto BrowserのUIから取得できます）。

"Profile not found"

プロファイル名は正確に一致する必要があります（大文字と小文字が区別されます）。利用可能なプロファイルを検索するには、octo_search_profilesを使用してください。

WebSocket接続が失敗する

Octo Browserが別のホストで実行されている場合：

1. ポート58888がアクセス可能であることを確認してください。
2. CDPポート（各プロファイルごとにランダム）がアクセス可能であることを確認してください。
3. OCTO_HOSTを正しいIPアドレスに設定してください。

🔧 開発

セットアップ

git clone https://github.com/anthropics/octo-mcp.git
cd octo-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

テストの実行

pytest

コードスタイル

ruff check .
ruff format .

📄 ライセンス

MITライセンス - LICENSEファイルを参照してください。

リンク

• Octo Browser
• Octo Browser API Documentation
• Model Context Protocol
• Claude Code