Stealth Browser MCP Server 使用说明

项目简介

Stealth Browser MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它利用 Playwright 浏览器自动化工具和 puppeteer-extra-plugin-stealth 插件，提供了具备反bot检测能力的隐身浏览功能。通过该服务器，LLM 客户端可以调用工具来安全地访问网页并进行截图，绕过常见的反爬虫机制。

主要功能点

隐身浏览: 利用 'puppeteer-extra-plugin-stealth' 插件，模拟真实用户行为，绕过网页的 bot 检测。
网页截图: 提供 'screenshot' 工具，支持对指定 URL 的网页进行全页或指定元素的截图。
MCP 协议支持: 完全兼容 Model Context Protocol，可以通过标准的 MCP 客户端进行访问和控制。

安装步骤

安装 Bun: 确保你的系统已经安装了 Bun。如果未安装，请根据 Bun 官网的指引进行安装。
安装依赖: 克隆仓库到本地后，在项目根目录下运行以下命令安装项目依赖：
```
bun install
```

服务器配置

MCP 客户端需要配置以下信息才能连接到 Stealth Browser MCP Server。以下是一个 JSON 格式的配置示例，请根据你的实际情况进行配置：

{
  "serverName": "stealth-browser-mcp",  // MCP 服务器名称，与代码中定义的一致
  "command": "bun",                   // 启动服务器的命令，这里使用 bun 运行时
  "args": ["start"]                    // 启动命令的参数，"start" 对应 package.json 中的 start 脚本
}

配置参数说明:

'serverName': 服务器名称，必须与 'index.ts' 文件中 'new FastMCP({...})' 定义的 'name' 属性值 '"stealth-browser-mcp"' 一致。
'command': 启动服务器的可执行命令。本项目使用 Bun 运行时，所以设置为 '"bun"'。如果你的环境中 'bun' 不在 PATH 环境变量中，需要填写 'bun' 的完整路径。
'args': 启动命令的参数，以数组形式提供。根据 'package.json' 中的 'scripts' 配置，'"start"' 参数会执行 'bun run index.ts' 启动服务器。

基本使用方法

启动服务器: 在项目根目录下运行以下命令启动 MCP 服务器：
```
bun start
```
服务器启动成功后，会输出 'MCP server started and waiting for commands...' 提示信息。
查看可用工具: 你可以运行以下命令查看服务器提供的工具列表：
```
bun inspect
```
该命令会列出服务器注册的所有工具及其详细信息，包括 'screenshot' 工具的参数说明。
使用 MCP 客户端调用工具: 配置好 MCP 客户端后，即可通过客户端向 Stealth Browser MCP Server 发送 MCP 请求，调用 'screenshot' 工具进行网页截图。具体工具参数请参考 'bun inspect' 命令的输出信息或 'README.md' 中 "Available Tools" 部分的描述。

示例工具调用 (screenshot): 假设你需要截取 'https://example.com' 网站的全页截图，并以 base64 格式返回。你需要构造符合 MCP 协议的 JSON-RPC 请求，通过 MCP 客户端发送给 Stealth Browser MCP Server。服务器会执行截图操作，并将截图数据封装在 JSON-RPC 响应中返回给客户端。

注意: Stealth Browser MCP Server 通过 STDIO 传输协议与客户端通信。确保你的 MCP 客户端支持 STDIO 协议，并按照上述配置信息正确配置客户端。

关键词