Steel MCP Server

Steel MCP Server

site icon
2025.05.06 0
JavaScript浏览器自动化网页交互AI辅助工具浏览器自动化开发效率
Steel MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,旨在通过 Puppeteer 和 Steel 技术使大型语言模型(如 Claude)能够自动化执行网页浏览任务。该服务器提供了标准的网页操作工具,如点击、滚动、输入、截图等,并支持本地和云端两种运行模式。
View on GitHub

Overview

基本能力

产品定位

Steel MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,旨在通过 Puppeteer 和 Steel 技术使大型语言模型(如 Claude)能够自动化执行网页浏览任务。

核心功能

  • 浏览器自动化(基于 Puppeteer)
  • Steel 集成,用于浏览器会话管理
  • 通过编号标签进行视觉元素识别
  • 截图功能
  • 基本网页交互(导航、点击、表单填写)
  • 通过滚动支持懒加载
  • 支持本地和远程 Steel 实例

适用场景

  • 搜索食谱并保存配料表
  • 跟踪包裹配送状态
  • 查找并比较特定产品的价格
  • 填写在线工作申请

工具列表

  • navigate: 导航到任何 URL
  • search: 执行 Google 搜索
  • click: 点击页面上的元素
  • type: 在输入字段中输入文本
  • scroll_down: 向下滚动页面
  • scroll_up: 向上滚动页面
  • go_back: 返回上一页
  • wait: 等待页面加载
  • save_unmarked_screenshot: 捕获当前页面截图

常见问题解答

  1. 验证 Steel API 密钥和网络连接
  2. 通过 GLOBAL_WAIT_SECONDS 环境变量添加延迟
  3. 确保页面完全加载并检查视口大小设置
  4. 手动释放会话以避免资源占用
  5. 优化提示以提高性能
  6. 使用会话查看器分析问题
  7. 注意浏览器操作过多可能导致性能下降

使用教程

使用依赖

  1. 安装最新版本的 Git 和 Node.js
  2. 安装 Claude Desktop
  3. (可选)本地运行 Steel Docker 镜像
  4. (可选)如果使用 Steel Cloud,获取 API 密钥 here

安装教程

Steel Cloud 模式

  1. 克隆并构建项目: bash git clone https://github.com/steel-dev/steel-mcp-server.git cd steel-mcp-server npm install npm run build
  2. 配置 Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json): json { "mcpServers": { "steel-puppeteer": { "command": "node", "args": ["path/to/steel-voyager/dist/index.js"], "env": { "STEEL_LOCAL": "false", "STEEL_API_KEY": "YOUR_STEEL_API_KEY_HERE", "GLOBAL_WAIT_SECONDS": "1" } } } }
  3. 启动 Claude Desktop

本地/自托管模式

  1. 确保本地 Steel 服务运行
  2. 克隆并构建项目(同上)
  3. 配置 Claude Desktop: json { "mcpServers": { "steel-puppeteer": { "command": "node", "args": ["path/to/steel-voyager/dist/index.js"], "env": { "STEEL_LOCAL": "true", "STEEL_BASE_URL": "http://localhost:3000", "GLOBAL_WAIT_SECONDS": "1" } } } }
  4. 启动 Claude Desktop

调试方式

  1. 检查环境变量配置是否正确
  2. 验证 API 密钥和网络连接
  3. 使用 GLOBAL_WAIT_SECONDS 调整等待时间
  4. 检查本地 Steel 服务是否正常运行
  5. 查看服务器日志以排查问题

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。