Steel Puppeteer

🚀 钢傀儡服务器

钢傀儡服务器是一个基于模型上下文协议（MCP）的服务器，借助Puppeteer和Steel实现浏览器自动化功能。它能让大型语言模型（LLM）在真实的浏览器环境中与网页交互、截取屏幕截图，还能执行JavaScript，为网页自动化操作提供了强大支持。

🚀 快速开始

服务器配置

1. 安装依赖项：

npm install

2. 构建项目：

npm run build

3. 启动服务器：

npm start

4. 打开Claude Desktop并开始浏览！

✨ 主要特性

• 支持Puppeteer的高级浏览器自动化功能。
• 集成Steel协议，实现与LLM的无缝交互。
• 提供灵活的配置选项和扩展能力。
• 支持本地和云端部署。

📦 安装指南

环境变量

以下环境变量可用于自定义服务器行为：

• PORT：指定服务器运行的端口（默认值：3000）。
• STEEL_API_KEY：Steel服务的API密钥。
• PUPPETEER_WS_ENDPOINT：Puppeteer WebSocket端点。

💻 使用示例

工具

puppeteer_navigate

• 功能：在浏览器中导航到任意URL。
• 输入：
  • url (字符串，必填)：要导航的URL。
  • timeout (数字，可选，默认值：60000)：导航超时时间（以毫秒为单位）。
  • waitUntil (字符串，可选，默认值："domcontentloaded")：考虑导航成功的条件。选项："load"、"domcontentloaded"、"networkidle0"、"networkidle2"。

puppeteer_screenshot

• 功能：截取网页或特定元素的屏幕截图。
• 输入：
  • name (字符串，必填)：屏幕截图的名称。
  • selector (字符串，可选)：要截取的元素的CSS选择器。

puppeteer_click

• 功能：点击网页上的元素。
• 输入：
  • selector (字符串，必填)：要点击的元素的CSS选择器。

puppeteer_fill

• 功能：填写表单字段。
• 输入：
  • selector (字符串，必填)：表单字段的CSS选择器。
  • value (字符串，必填)：要填写的值。

puppeteer_select

• 功能：在SELECT标签中选择元素。
• 输入：
  • selector (字符串，必填)：要选择的元素的CSS选择器。
  • value (字符串，必填)：要选择的值。

资源

该服务器提供以下资源以支持浏览器自动化操作：

• 截图功能。
• 元素交互（点击、填写等）。
• 浏览器事件监听与控制。

📚 详细文档

故障排除

• 如果遇到Puppeteer相关问题，请确保系统上安装了必要的依赖项。请参考Puppeteer故障排除指南获取更多信息。
• 如果使用Steel云服务，请确保API密钥有效且具有必要权限。
• 如果使用本地Steel实例，请确保其正在运行并可访问指定URL（如果是自定义）或默认本地地址。

更多详细配置选项和高级用法，请参考Steel文档和Puppeteer API参考。