Skip to main content
Glama
MCP Browser Agent

MCP Browser Agent

by ashley-ha

MCP ブラウザエージェント

鍛冶屋のバッジ

AGI House MCPハッカソンで構築

概要

このプロジェクトは、モデルコンテキストプロトコル(MCP)を使用してブラウザインタラクションを可能にするブラウザ自動化エージェントです。MCPサーバーを介して、Claudeとブラウザ自動化機能をシームレスに統合します。

MCP サーバーの強化に役立つブラウザー エージェント機能を提供してくれた Browser-Use に感謝します。

Related MCP server: selenium-mcp

システム要件

  • macOS (ダーウィン 24.2.0)

  • Python 3.12以上

  • uvパッケージマネージャー

  • Google Chrome ブラウザ (タスクを実行する前にブラウザが閉じていることを確認してください。)

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Browser Automation Agent を自動的にインストールするには:

npx -y @smithery/cli install @ashley-ha/mcp-manus --client claude

手動インストール

  1. リポジトリをクローンします。

git clone <repository-url>
cd mcp
  1. uvを使用して Python 環境をセットアップします。

uv venv
source .venv/bin/activate
uv sync

構成

クロードデスクトップ構成

Claude Desktop 構成ファイルを作成または変更します。

{
  "mcpServers": {
    "browser-use": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/mcp",
        "run",
        "browser-use.py"
      ]
    }
  }
}

/ABSOLUTE/PATH/TO/browser-useプロジェクト ディレクトリへの絶対パスに置き換えます。

ブラウザの設定

エージェントは、次のデフォルト設定で Google Chrome を使用するように構成されています。

  • 開発用の非ヘッドレスモード

  • ウィンドウサイズ: 1280x1100

  • テストのためにセキュリティ機能を無効にしました

  • 録音パス: ./tmp/recordings

特徴

  • MCPツールによるブラウザ自動化

  • 国家管理および計画能力

  • インタラクティブな要素の検出と操作

  • 設定可能なブラウザコンテキスト

  • ログ記録とデバッグのサポート

使用法

エージェントは主に 2 つのツールを提供します。

  1. get_planner_state : 現在のブラウザの状態と計画コンテキストを取得します

  2. execute_actions : ブラウザで計画されたアクションを実行する

発達

ログ記録

このプロジェクトでは、次の構成で Python の組み込みログ記録を使用します。

  • すべてのログはstderrに送信されます

  • カスタム書式: %(levelname)-8s [%(name)s] %(message)s

  • ルートロガーレベル: INFO

  • サードパーティのロガーレベル: 警告

プロジェクト構造

  • browser-use.py : メインエントリポイントとサーバーの実装

  • tmp/recordings : ブラウザセッションの記録用のディレクトリ

  • uvを通じて管理される依存関係

貢献

このプロジェクトはAGI House MCPハッカソン中に構築されました。貢献を歓迎します!

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

著作権 (c) 2025 Jaeyun Ha、Ashley Ha

本ソフトウェアおよび関連ドキュメント ファイル (以下「本ソフトウェア」) のコピーを入手したすべての人物は、以下の条件に従い、本ソフトウェアを無制限に扱う権利 (使用、コピー、変更、統合、公開、配布、サブライセンス、および/または販売する権利を含みますが、これに限定されません) および本ソフトウェアの提供を受けた人物が同様の行為を行うことを許可する権利を無償で付与されます。

上記の著作権表示およびこの許可通知は、ソフトウェアのすべてのコピーまたは大部分に含めるものとします。

本ソフトウェアは「現状有姿」で提供され、明示的または黙示的を問わず、商品性、特定目的への適合性、非侵害性を含むがこれらに限定されない、いかなる種類の保証も付与されません。いかなる場合においても、著作者または著作権者は、契約違反、不法行為、またはその他の行為にかかわらず、本ソフトウェア、本ソフトウェアの使用、またはその他の取り扱いに起因または関連して発生するいかなる請求、損害、またはその他の責任についても責任を負わないものとします。

Available Tools

2 tools
execute_actionsB

Execute actions from the planner state.

Args:
    actions: A dictionary containing the planner state and actions in format:
            {
                "current_state": {
                    "evaluation_previous_goal": str,
                    "memory": str,
                    "next_goal": str
                },
                "action": [
                    {"action_name": {"param1": "value1"}},
                    ...
                ]
            }
            
Note: If the page state changes (new elements appear) during action execution,
the sequence will be interrupted and you'll need to get a new planner state.

Inputs: actions (required).

get_planner_stateA

Get the current browser state and planning context. This tool must be executed before execute_actions tool.

Must return a JSON string in the format:
{
    "current_state": {
        "evaluation_previous_goal": "Success|Failed|Unknown - Analysis of previous actions",
        "memory": "Description of what has been done and what to remember",
        "next_goal": "What needs to be done with the next immediate action"
    },
    "action": [
        {"action_name": {"param1": "value1", ...}},
        ...
    ]
}

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: get_planner_state retrieves browser state and planning context, while execute_actions performs actions based on that state. There is no overlap or ambiguity between these functions.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern with clear action-oriented names (get_planner_state, execute_actions). The naming convention is uniform and predictable throughout the set.

    Tool Count2/5

    With only 2 tools for a browser automation server, the surface feels severely limited. While the tools cover a basic planning-execution loop, typical browser automation requires more granular operations like navigation, element interaction, or content extraction.

    Completeness2/5

    The toolset provides only a high-level planning/execution abstraction without direct browser manipulation capabilities. There are significant gaps for common browser tasks like navigating to URLs, clicking elements, extracting text, or handling dialogs, which agents would need for robust automation.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      A Model Context Protocol (MCP) integration that provides Claude Desktop with autonomous browser automation capabilities. This agent enables Claude to interact with web content, manipulate DOM elements, execute JavaScript, and perform API requests.
      13
      43
      TypeScript
      Mozilla Public 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables browser automation through the Claude Chrome Extension, allowing agents to navigate websites, fill forms, take screenshots, and debug web apps via standard MCP protocols.
      1
      MIT