金大哥 - rdvo_mcp-server MCP 详情

article

README

🚀 钢傀儡模型上下文协议服务器

钢傀儡模型上下文协议服务器借助Puppeteer和Steel提供的浏览器自动化能力，让大语言模型（LLM）能够与网页交互、截取屏幕截图以及执行JavaScript代码，为其提供真实的浏览器环境。

🚀 快速开始

运行步骤

安装依赖：
```
npm install
```
构建项目：
```
npm run build
```
启动服务器：
```
npm start
```
打开Claude桌面应用程序，即可开始使用！

默认情况下，服务器将在端口3000上监听请求。

✨ 主要特性

支持使用Puppeteer进行浏览器自动化操作。
提供强大的控制台功能以与网页交互。
支持多种滚动行为和块定位。
集成Steel协议进行模型上下文交互。
支持自定义用户代理字符串。
提供详细的日志记录和调试选项。

📦 安装指南

环境变量

以下是运行服务器所需的关键环境变量：

NODE_ENV：设置为"production"以启用生产模式，默认值："development"。
PORT：指定服务器监听的端口，范围1024到65535，默认值：3000。
PUPPETEER_WS_ENDPOINT：指定Puppeteer WebSocket端点，默认值：ws://localhost:3000/ws/puppeteer。
STEEL_API_KEY：Steel API密钥，用于身份验证。
STEEL_SERVER_URL：Steel服务URL，默认值：http://localhost:8080。

服务器配置

要自定义服务器行为，请编辑以下配置选项：

{
  "puppeteer": {
    "defaultViewport": { // 默认视口设置
      "width": 1920,
      "height": 1080,
      "deviceScaleFactor": 1,
      "isLandscape": true,
      "hasTouch": false,
      "isMobile": false
    },
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.126 Safari/537.36" // 自定义用户代理字符串
  },
  "steel": {
    "apiEndpoint": "http://localhost:8080", // Steel API端点
    "timeout": 30000, // 请求超时时间（毫秒）
    "proxyEnabled": true, // 是否启用代理
    "proxyUrl": "http://localhost:8081" // 代理服务器URL
  },
  "logging": {
    "enabled": true, // 启用日志记录
    "level": "info", // 日志级别："debug"、"info"、"warn"、"error"
    "outputFile": "./logs/server.log" // 日志输出文件路径
  }
}

📚 详细文档

组件

工具

| 工具名称 | 功能 | 输入参数 | | ---- | ---- | ---- | | 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_hover | 鼠标悬停在页面上的元素上 | selector (字符串，必需)：悬停的元素的CSS选择器 | | puppeteer_evaluate | 在浏览器控制台中执行JavaScript代码 | script (字符串，必需)：要执行的JavaScript脚本 | | puppeteer_get_content | 从当前页面提取内容 | selector (字符串，可选)：从特定元素获取内容的CSS选择器。如果未提供，则返回整个页面内容 | | puppeteer_scroll | 滚动页面以触发惰性加载 | behavior (字符串，可选，默认值："auto")：滚动行为（"auto" 或 "smooth"）
block (字符串，可选，默认值："start")：滚动块（"start"、"end"、"nearest"、"center"） |

资源

| 资源名称 | 功能 | | ---- | ---- | | 页面 | 提供对当前网页的访问 | | 截图 | 返回屏幕截图数据 | | 标题 | 返回当前页面的标题 | | 内容 | 返回当前页面的内容 | | cookies | 获取或设置当前页面的Cookie |

🔧 技术细节

故障排除

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

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

rdvo_mcp-server