Magus 浏览器使用型 MCP 服务器

关键词

Model Context ProtocolLLM context serviceJSON-RPCBrowser automation tools

使用说明（简要、直观，适合开发者快速上手）：

  • 项目简介 Magus 的这部分实现是一个在 Claude Code 生态内工作的 MCP 服务器示例。它通过一个 Python 编写的 MCP 服务器，将浏览器自动化相关的工具对外暴露给 MCP 客户端（如 Claude Code 插件或其他 LLM 客户端），客户端可以通过统一的 JSON-RPC 请求来读取资源、调用工具以及获取 Prompts 等能力。

  • 主要功能点

    1. 通过 MCP JSON-RPC 与客户端通信，注册并暴露浏览器自动化工具集合。
    2. 提供会话管理能力，能够在同一服务器进程中维护多个浏览器会话。
    3. 支持工具执行（如浏览器导航、获取状态、模拟输入等），并将结果以统一的响应返回。
    4. 提供服务器能力声明，允许客户端了解可用的工具和资源。
    5. 具备基本的容错与扩展性设计，可通过扩展插件继续增加资源与工具集。

  • 安装步骤

    1. 确保环境中有 Python 3.x 及 pip。
    2. 安装必要依赖，例如 browser-use 相关库与 MCP SDK（通过 pip 安装浏览器使用相关包与 MCP 软件包）。
    3. 将 mcp-server.py 放在可执行的位置，并确保具备运行权限。
    4. 根据实际环境调整依赖与路径，确保浏览器自动化组件可被服务器进程访问。

  • 服务器配置（供 MCP 客户端接入所需的基本信息） 服务器的客户端接入配置（JSON 格式）需包含服务器名称、启动命令与参数等信息，用于 MCP 客户端建立连接。示例配置如下（请按实际环境替换路径与参数）： { "server_name": "browser-use", "command": "python3", "args": ["mcp-server.py"], "transport": "stdio", "description": "Browser Use MCP 服务器，用于提供浏览器自动化工具的上下文与执行能力", "notes": "MCP 客户端通过该启动信息连接并通过 JSON-RPC 调用工具、读取资源、获取 Prompts 等后端能力" }

  • 基本使用方法

    1. 启动服务器：在具备 Python 环境的机器上执行启动命令（如上配置中指定的 command 与 args），服务器启动后将通过 MCP JSON-RPC 对外提供能力。
    2. MCP 客户端接入：按照客户端文档使用配置中的 server_name、command、args 等信息连接到服务器，客户端即可通过统一接口调用工具与获取资源信息。
    3. 运行与调试：在开发阶段可通过在 mcp-server.py 中添加或开启测试模式以验证请求-响应格式是否符合 MCP 规范，确保工具注册、资源访问和会话管理等核心功能可用。

服务器信息

访问项目