PhoneGrid Logo
Documentation
使用文档API 文档RPA 文档MCP 接入文档

Mcp 文档

PhoneGrid MCP 教程

通过 PhoneGrid MCP，您可以使用自然语言对话直接从支持 MCP 的 AI 工具（如 Claude、Cursor 等）控制 PhoneGrid，实现“浏览器环境管理”和“页面内自动化操作”。

支持的操作包括：启动浏览器环境、创建环境、在已打开的环境中访问网页、输入文本、点击元素、截图等。

配置步骤

  1. 安装并启动 PhoneGrid 客户端。如果尚未安装，请从官网下载最新版本：PhoneGrid 官网

  2. 打开 API & MCP 部分，等待 "PhoneGrid-mcp" 程序下载完成。

下载后，您不需要在本地安装或配置 Node.js。

API & MCP 界面

  1. "PhoneGrid-mcp" 下载完成后，点击 Copy（复制）来复制配置内容。

  2. 启动 Cursor 客户端，前往 Settings（设置） → Tools & MCP → Add Custom MCP（添加自定义 MCP），并添加配置。

在 Cursor 中添加自定义 MCP

  1. 将复制的 "PhoneGrid-mcp" 配置粘贴到 Cursor 中，并按 Ctrl+S（Mac 系统为 Cmd+S）保存。

粘贴并保存 MCP 配置

  1. 保存后，返回 Installed MCP Servers（已安装的 MCP 服务器）界面；如果看到 "phonegrid-mcp" 条目，则说明配置成功。

已安装的 MCP 服务器

使用示例

示例 1：自动化浏览器环境管理

在 Cursor 聊天框中输入自然语言指令。可以自动控制 PhoneGrid 而无需手动操作。

示例："请在 PhoneGrid 中创建 2 个 Chrome、Windows 系统的环境。"
Cursor 将通过 MCP 调用 PhoneGrid，根据需要创建、启动/关闭或删除环境。

示例 2：自动化页面内操作

对于已存在的环境，您可以打开它们并运行页面内自动化操作（导航、输入、点击、截图）。

示例："启动 'p-24' 环境，访问 www.google.com，在搜索框中输入 'phonegrid'，执行搜索，点击第一个结果，并给我发送一张截图。"

2. 在 Claude 中配置 PhoneGrid MCP

配置步骤

  1. 启动 Claude 客户端，前往 Settings（设置） → Developer（开发者） → Edit Config（编辑配置）以打开并编辑配置文件。

Claude 编辑配置

  1. 在文本编辑器中打开本地配置文件，粘贴 PhoneGrid MCP 配置（如果需要，请替换现有内容），然后按 Ctrl+S（Mac 系统为 Cmd+S）保存。

编辑配置文件

粘贴 MCP 配置

  1. 在 Settings（设置） → Connectors（连接器）中，如果出现 "phonegrid-mcp"，则说明配置成功。

Claude Code MCP 配置说明

使用示例

在 Claude 聊天框中输入自然语言指令；Claude 将通过 MCP 调用 PhoneGrid。使用方法与 Cursor 相同。

  1. 环境管理：创建、启动/关闭、删除环境等。
  2. 页面内自动化：打开网址、输入、点击元素、截图等。

3. 自适应 AI 引擎（可选）

当自动化流程较复杂，或者页面结构发生变化导致现有流程中断时，您可以配置 AI 模型并启用自适应引擎。它会实时调整策略并适应页面变化，从而保持自动化的可靠性。

适用场景：页面结构经常变动、存在大量动态元素，或者需要灵活处理边缘情况时。

自适应 AI 引擎