Steel MCP Server

基本能力

产品定位

Steel MCP Server 是一个为大型语言模型（如 Claude）提供网页浏览和自动化功能的 MCP 服务。它通过 Puppeteer 和 Steel 框架实现网页交互，支持多种网页操作和截图功能。

核心功能

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

适用场景

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

工具列表

• navigate: 导航到指定 URL
• search: 执行 Google 搜索
• click: 点击页面上的元素
• type: 在输入框中输入文本
• scroll_down: 向下滚动页面
• scroll_up: 向上滚动页面
• go_back: 返回上一页
• wait: 等待指定秒数
• save_unmarked_screenshot: 捕获并保存无标记的屏幕截图

常见问题解答

1. API 密钥验证问题：确保 Steel API 密钥正确且本地 Steel 实例正在运行。
2. 页面渲染问题：尝试通过 GLOBAL_WAIT_SECONDS 环境变量添加延迟。
3. 页面加载问题：确保页面已完全加载，并检查视口大小设置。
4. 会话清理问题：可能需要手动释放会话。
5. 性能问题：优化提示方式以提高性能。
6. 上下文窗口填充问题：过多的浏览器操作可能导致 Claude 响应变慢。

使用教程

使用依赖

1. 安装最新版本的 Git 和 Node.js
2. 安装 Claude Desktop
3. （可选）本地运行 Steel Docker 镜像
4. （可选）如果使用 Steel Cloud，准备 API 密钥（从 这里 获取）

安装教程

A) 快速启动（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

B) 快速启动（本地/自托管 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. 本地开发： bash npm install npm run build npm start
2. 检查环境变量配置是否正确
3. 查看服务器日志以排查问题

许可证

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