Steel MCP Server

基本能力

产品定位

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 密钥并确保本地 Steel 实例正在运行。
2. 如果页面渲染或标记有问题，尝试通过 GLOBAL_WAIT_SECONDS 环境变量添加延迟。
3. 确保页面已完全加载，并检查视口大小设置。
4. 会话清理目前不够完善，可能需要手动释放会话。
5. 正确的提示方式可以显著提高性能并避免错误。
6. 利用会话查看器分析模型可能遇到的问题。
7. 在约 15-20 次浏览器操作后，Claude 可能会因上下文窗口被图像填满而变慢。

使用教程

使用依赖

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

快速开始（本地/自托管 Steel）

1. 确保本地或自托管的 Steel 服务正在运行
2. 克隆并构建项目（同上）
3. 配置 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": "true", "STEEL_BASE_URL": "http://localhost:3000", "GLOBAL_WAIT_SECONDS": "1" } } } }
4. 启动 Claude Desktop

调试方式

1. 检查 Steel API 密钥是否正确
2. 检查本地 Steel 实例是否运行
3. 使用 GLOBAL_WAIT_SECONDS 环境变量调整延迟
4. 检查页面加载状态和视口设置
5. 使用会话查看器分析问题

许可证

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