使用说明
@aifirelab/mcpinchtab
MCP服务器 夹片 --AI代理的浏览器自动化。
它做什么
将Claude(或任何MCP客户端)连接到本地Pinchtab服务器,以进行无头浏览器控制。提供16个工具,用于导航页面、单击元素、填写表单、截图等。
- 在stdio上工作——与Claude Code、Claude Desktop和任何MCP客户端兼容
- 使用Pinchtab的可访问性树快照进行令牌高效的页面理解
- 所有交互都使用元素引用(
e0,e1, ...)来自快照——不需要CSS选择器
先决条件
- Node.js 18+
- 夹片 全局安装:
npm i -g pinchtab
快速入门--克劳德代码
添加到您的 .mcp.json:
{
"mcpServers": {
"pinchtab": {
"type": "stdio",
"command": "npx",
"args": ["@aifirelab/mcp-pinchtab"]
}
}
}
快速入门--克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"pinchtab": {
"command": "npx",
"args": ["@aifirelab/mcp-pinchtab"]
}
}
}
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
PINCHTAB_URL |
http://localhost:9867 |
覆盖Pinchtab服务器URL |
PINCHTAB_BIN |
pinchtab (来自PATH) |
覆盖pinchtab二进制路径 |
工具
| 工具 | 说明 | 关键参数 |
|---|---|---|
navigate |
将浏览器导航到URL | url, newTab? |
snapshot |
获取页面的可访问性树快照(令牌高效) | interactive?, compact? |
click |
按ref单击元素 | ref, human? |
type_text |
逐个字符键入文本 | ref, text, human? |
fill |
立即填写表单字段(清除现有值) | ref, value |
press |
按键盘键 | key, ref? |
select |
从下拉列表中选择一个选项 | ref, value |
scroll |
滚动页面或元素 | direction, amount?, ref? |
hover |
将鼠标悬停在元素上 | ref |
get_text |
提取当前页面的文本内容 | -- |
screenshot |
截图(base64 JPEG) | -- |
evaluate |
在浏览器中执行JavaScript | expression |
list_tabs |
列出所有打开的浏览器选项卡 | -- |
close_tab |
关闭当前或特定选项卡 | tabId? |
get_cookies |
获取当前页面的所有Cookie | -- |
health |
检查Pinchtab服务器是否正在运行 | -- |
许可证
麻省理工学院