使用说明

项目简介

CEO Agent Framework MCP Server 是 CEO Agent Framework 的扩展，它通过 Model Context Protocol (MCP) 为 LLM 智能体提供强大的浏览器自动化能力。该服务器将 Playwright 浏览器自动化工具集封装为 MCP 协议下的工具，使得 LLM 能够通过标准的 MCP 接口与网页进行交互，执行网页浏览、信息搜索、屏幕截图、元素点击、表单填写等操作。

主要功能点

Playwright 工具集成: 将 Playwright 提供的浏览器自动化功能（如页面导航、截图、点击、内容填充、JavaScript 执行等）以 MCP 工具的形式对外暴露。
标准 MCP 协议: 遵循 Model Context Protocol 标准，方便与各种 MCP 客户端集成，实现 LLM 智能体与 Web 环境的互操作。
Stdio 传输协议: 支持基于标准输入输出流 (Stdio) 的传输协议，简化服务器部署和客户端连接配置。
开箱即用: 提供可直接运行的 MCP 服务器 Python 脚本 'playwright-plus-python-mcp.py'，快速启动浏览器自动化服务。

安装步骤

安装 ceo-py: 确保已安装 Python 环境和 pip 包管理器。使用 pip 安装 'ceo-py' 库，其中包含了运行 MCP 服务器所需的依赖：
```
pip install ceo-py
```
安装 'ceo-py' 会自动安装 'mcp' 库以及其他相关依赖。
安装 Playwright 浏览器: 首次运行 'playwright-plus-python-mcp.py' 脚本时，会自动执行 'playwright install' 命令安装 Playwright 浏览器驱动，无需手动安装。

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 CEO Agent Framework MCP Server。这些配置信息指定了服务器的启动方式：

{
  "server name": "playwright-server",
  "command": "python",
  "args": ["./demo/mcp_server/playwright-plus-python-mcp.py"]
  // "server name"：  MCP 服务器的名称，用于标识和管理连接。
  // "command"：     启动 MCP 服务器的命令，这里使用 python 解释器。
  // "args"：        传递给启动命令的参数列表，"./demo/mcp_server/playwright-plus-python-mcp.py" 指定了服务器脚本的路径。
}

基本使用方法

启动 MCP 服务器: 无需手动启动，MCP 客户端在需要连接时，会根据上述配置信息自动启动 'playwright-plus-python-mcp.py' 脚本作为 MCP 服务器。
客户端连接与工具调用: 在 MCP 客户端（例如使用 'ceo-py' 库的 'McpAgent'）中，配置上述服务器信息，客户端即可通过 MCP 协议与服务器建立连接，并发现和调用 Playwright 提供的浏览器自动化工具，例如 'playwright_navigate' (页面导航), 'playwright_screenshot' (屏幕截图), 'playwright_click' (元素点击) 等，从而实现 LLM 智能体对 Web 页面的自动化操作。
示例代码: 仓库 'demo/mcp_agent.py' 提供了使用 'McpAgent' 连接和调用 MCP 服务器工具的示例代码，可供参考。

关键词

使用说明

信息