使用说明
pptr mcp
通过Puppeteer实现浏览器自动化的MCP服务器。与其他公开固定工具（导航、单击、截图）的浏览器MCP不同，此服务器执行任意JavaScript代码，可以直接访问Puppeteer browser实例。
主要区别
大多数浏览器MCP服务器提供一组有限的预定义操作。对于复杂的工作流程，这种方法需要多次往返，无法处理边缘情况。
pptr mcp 采用不同的方法：它公开了一个 execute 在Node.js虚拟机中运行JavaScript代码的工具 browser 全球的。您直接编写Puppeteer代码，在一次调用中获得完整的API访问权限。
Traditional MCP (5 round-trips) pptr-mcp (1 round-trip)
================================ ================================
Agent Server Agent Server
| | | |
|-- navigate --->| |-- execute ---->|
|<-- ok ---------| | |
| | | +------------------------+
|-- waitFor ---->| | | const page = await |
|<-- ok ---------| | | browser.newPage(); |
| | | | await page.goto(url); |
|-- click ------>| | | await page.click(s); |
|<-- ok ---------| | | await page.type(i, t); |
| | | | return await |
|-- type ------->| | | page.screenshot(); |
|<-- ok ---------| | +------------------------+
| | | |
|-- screenshot ->| |<-- result -----|
|<-- image ------| | |
| | | |
需求
- Node.js>=20
安装
npm install -g pptr-mcp
MCP配置
添加到您的MCP客户端配置中（例如，Claude Desktop）：
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["pptr-mcp"]
}
}
}
使用CLI选项：
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["pptr-mcp", "--no-headless", "--viewport=1080p"]
}
}
}
带有自定义Chrome标志（之后 --):
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": [
"pptr-mcp",
"--viewport=1280x720",
"--",
"--proxy-server=http://proxy:8080"
]
}
}
}
CLI选项
| 选项 | 描述 |
|---|---|
--no-headless |
使用可见的浏览器窗口运行 |
--viewport=VALUE |
设置视口大小（例如1920x1080或1080p） |
--help, -h |
显示帮助 |
-- [args] |
将剩余参数传递给Chrome |
之前未知的选项 -- 也传递给Chrome。
Claude代码插件
安装为Claude Code插件：
/plugin marketplace add iatsiuk/pptr-mcp
/plugin install pptr-mcp@pptr-mcp
环境变量
| 变量 | 描述 |
|---|---|
CHROME_PATH |
Chrome可执行文件的路径 |
PUPPETEER_EXECUTABLE_PATH |
CHROME_PATH的替代方案 |
PUPPETEER_CACHE_DIR |
浏览器下载缓存目录 |
PPTR_MCP_TIMEOUT |
执行超时（毫秒）（默认值：30000） |
工具：执行
通过访问Puppeteer浏览器执行JavaScript代码。
参数
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
code |
string | 必需 | 要执行的JavaScript代码 |
persistent |
boolean | true | 跨调用重用浏览器会话 |
食谱
禁用无头模式
执行期间显示浏览器窗口：
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["pptr-mcp", "--no-headless"]
}
}
}
自定义Chrome配置文件目录
使用您自己的Chrome个人资料，保存登录信息和Cookie：
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["pptr-mcp", "--", "--user-data-dir=/path/to/profile"]
}
}
}
使用系统Chrome而不是下载
默认情况下，pptr-mcp会下载Chrome for Testing，这是一个针对捆绑的Puppeteer进行优化和测试的版本。要使用您的系统Chrome，请执行以下操作：
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["pptr-mcp"],
"env": {
"CHROME_PATH": "/path/to/chrome"
}
}
}
}
安全
此服务器设计用于 值得信赖的地方发展 与法学硕士助理（Claude Code、Cursor等）合作。根据您的请求，执行代码来自LLM。
这意味着什么
- 不是沙盒：Node.js VM隔离代码是为了方便，而不是为了安全。它不是为运行不受信任的代码而设计的。
- 完全浏览器控制：执行的代码可以导航到任何URL，读取页面内容，截图，并与web应用程序交互。
- Chrome在没有沙箱的情况下运行:
--no-sandbox标志用于Docker/容器兼容性。 - 持续会话：与
persistent: true（默认），Cookie和浏览器状态在调用过程中会被保留。使用persistent: false为了隔离。
不是为
- 多租户或共享服务器部署
- 执行来自外部源的不受信任的代码
- 构建接受任意用户输入的web服务
