浏览器自动化服务

MCP Pinchtab是一个用于AI代理的浏览器自动化服务,通过本地Pinchtab服务器提供页面导航、元素点击、表单填充、截图等功能。

  • by Ai-firelab
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Ai-firelab/mcp-pinchtab

使用说明

@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服务器是否正在运行 --

许可证

麻省理工学院