Rdvo MCP Server

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

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

🚀 快速开始

运行步骤

1. 安装依赖：

   npm install
   

2. 构建项目：

   npm run build
   

3. 启动服务器：

   npm start
   

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

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