基于Java开发的浏览器自动化MCP服务器

这是使用 Java 语言开发的一个简单的浏览器自动化 MCP 服务器，并通过 Cherry Studio 进行测试。

功能概述

• 支持导航到指定 URL
• 提供截图功能以捕获页面状态
• 支持点击、选择、填写表单字段等常见浏览器操作
• 集成日志记录和异常处理机制

安装依赖

将以下 Maven 依赖添加到你的项目中：

使用 MCP 官方的 Java SDK

<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp</artifactId>
    <version>0.10.0</version>
</dependency>

对于 HTTP SSE 传输实现，添加以下依赖之一：

基于 Spring WebFlux 的 SSE 客户端和服务器传输

<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp-spring-webflux</artifactId>
</dependency>

基于 Spring WebMVC 的 SSE 服务器传输

<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp-spring-webmvc</artifactId>
</dependency>

快速开始

1. 克隆仓库：git clone https://github.com/yourusername/Playwright-MCP.git
2. 构建项目：mvn clean install
3. 启动服务：java -jar target/Playwright-MCP.jar

驱动安装

PlayWright需要浏览器驱动，程序自动检测是否存在驱动，不存在就会自动安装，但安装取决于网路，经常会失败，所以还是手动安装的好。

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install"

默认安装三大浏览器驱动webkit、chromium、firefox。 你还可以通过提供参数来安装特定的浏览器：

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install chromium"

客户端测试

1. 配置mcp服务

2. 提问

示例用法

你可以通过如下方式与浏览器进行交互：

• 导航至特定网页
• 捕获页面截图
• 对页面上的元素执行点击、选择、输入等操作