Steel MCP Server 使用说明

项目简介

Steel MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,它利用 Puppeteer 自动化工具和 Steel 服务,为大型语言模型 (LLM) 提供与网页进行交互的能力。通过该服务器,LLM 可以执行如网页导航、信息搜索、点击、填写表单、滚动页面以及截图等操作,从而扩展 LLM 在网络环境中的应用场景。

主要功能点

  • 网页自动化: 基于 Puppeteer 实现网页的自动化操作。
  • 工具集成: 提供一系列预定义的网页操作工具,如导航、搜索、点击、输入等。
  • 资源管理: 可以保存和管理网页截图资源,并通过 MCP 协议提供访问。
  • 本地/云端支持: 支持连接本地或云端的 Steel 服务,灵活适应不同部署环境。
  • 可视化辅助: 在网页交互时,通过编号标签和边框高亮显示可操作元素,方便 LLM 理解和操作网页。

安装步骤

  1. 克隆仓库
    git clone https://github.com/steel-dev/steel-mcp-server.git
    cd steel-mcp-server
  2. 安装依赖
    npm install
  3. 构建项目
    npm run build

服务器配置

要将 Steel MCP Server 集成到 MCP 客户端(例如 Claude Desktop),您需要配置客户端以连接到该服务器。以下是针对 Claude Desktop 客户端的配置示例,您需要将以下 JSON 配置添加到 Claude Desktop 的配置文件 ('~/Library/Application Support/Claude/claude_desktop_config.json') 中。

云端 Steel 模式配置 (连接 Steel Cloud 服务):

{
  "mcpServers": {
    "steel-puppeteer": {
      "command": "node",
      "args": ["path/to/steel-mcp-server/dist/index.js"],
      "env": {
        "STEEL_LOCAL": "false",
        "STEEL_API_KEY": "YOUR_STEEL_API_KEY_HERE",
        "GLOBAL_WAIT_SECONDS": "1"
      }
    }
  }
}
  • server name (steel-puppeteer): 服务器名称,可以自定义,用于在客户端中标识该服务器。
  • command (node): 启动服务器的命令,这里使用 Node.js 运行 JavaScript 文件。
  • args (["path/to/steel-mcp-server/dist/index.js"]): 启动命令的参数,指向编译后的服务器入口文件 'index.js' 的路径。请将 'path/to/steel-mcp-server' 替换为您的 'steel-mcp-server' 仓库在您电脑上的实际路径。
  • env (环境变量配置): 配置服务器运行所需的环境变量。
    • STEEL_LOCAL (false): 设置为 'false' 表示使用云端 Steel 服务。
    • STEEL_API_KEY (YOUR_STEEL_API_KEY_HERE): 您的 Steel Cloud API 密钥。请替换为您的实际 API 密钥。 您可以在 Steel 开发者平台 获取。
    • GLOBAL_WAIT_SECONDS (1): 全局等待时间,单位为秒。在每次工具执行后等待指定秒数,以确保页面加载完成。

本地 Steel 模式配置 (连接本地部署的 Steel 服务):

{
  "mcpServers": {
    "steel-puppeteer": {
      "command": "node",
      "args": ["path/to/steel-mcp-server/dist/index.js"],
      "env": {
        "STEEL_LOCAL": "true",
        "STEEL_BASE_URL": "http://localhost:3000",
        "GLOBAL_WAIT_SECONDS": "1"
      }
    }
  }
}
  • server name (steel-puppeteer): 服务器名称,可以自定义。
  • command (node): 启动服务器的命令。
  • args (["path/to/steel-mcp-server/dist/index.js"]): 启动命令的参数,指向服务器入口文件路径。请将 'path/to/steel-mcp-server' 替换为您的实际路径。
  • env (环境变量配置):
    • STEEL_LOCAL (true): 设置为 'true' 表示使用本地 Steel 服务。
    • STEEL_BASE_URL (http://localhost:3000): 本地 Steel 服务的 URL。如果您的本地 Steel 服务运行在其他地址,请修改此配置。
    • GLOBAL_WAIT_SECONDS (1): 全局等待时间,单位为秒。

基本使用方法

  1. 启动 MCP 服务器: 在 'steel-mcp-server' 仓库目录下,运行 'npm start' 命令启动服务器。
  2. 配置 MCP 客户端: 根据您选择的云端或本地 Steel 模式,配置您的 MCP 客户端(例如 Claude Desktop),填入上述相应的 JSON 配置信息。
  3. 在 MCP 客户端中使用: 启动您的 MCP 客户端(例如 Claude Desktop),客户端将自动连接到 Steel MCP Server。现在您可以指示 LLM 执行网页相关的任务,例如:
    • "搜索食谱并保存配料清单"
    • "追踪包裹递送状态"
    • "查找并比较特定产品的价格"
    • "填写在线职位申请"

LLM 将通过 Steel MCP Server 调用相应的工具来完成您的指令,实现网页自动化操作。

信息

分类

网页与API