Shiplight

Name: Shiplight
Author: shiplight.ai

本地服务

shiplight.ai浏览器自动化

访问官网

关于 Shiplight

提供浏览器自动化的 MCP 服务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ai-shiplight-shiplight": {
      "command": "npx",
      "args": [
        "-y",
        "@shiplightai/mcp"
      ],
      "env": {
        "PWDEBUG": "<PWDEBUG>"
      }
    }
  }
}

启动命令npx -y @shiplightai/mcp

需要配置的环境变量

PWDEBUGMust be set to "console". Enables Playwright semantic locator generation (getByRole, getByTestId) for action entities. Without it, only XPath locators are available.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@shiplightai/mcp0.2.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
starting_url	string	否	起始 URL（默认为 about:blank）
browser_options	object	否	浏览器启动和模拟选项。
browser_options.proxy	object	否	代理配置
browser_options.proxy.server	string	是
browser_options.proxy.password	string	否
browser_options.proxy.username	string	否
browser_options.locale	string	否	浏览器区域设置（例如，'en-US'、'ja-JP'）
browser_options.headless	boolean	否	以无头模式运行浏览器
browser_options.viewport	object	否	视口大小。默认值：1280x720。常见尺寸：移动设备（390x844）、平板电脑（768x1024）、桌面设备（1920x1080）。
browser_options.viewport.width	number	是	视口宽度（像素）
browser_options.viewport.height	number	是	视口高度（像素）
browser_options.has_touch	boolean	否	启用触摸事件。默认值：false
browser_options.is_mobile	boolean	否	模拟移动设备行为（移动版 CSS 媒体查询、meta viewport 标签）。默认值：false
browser_options.user_agent	string	否	自定义 user agent 字符串
browser_options.geolocation	object	否	模拟地理位置
browser_options.geolocation.accuracy	number	否
browser_options.geolocation.latitude	number	是
browser_options.geolocation.longitude	number	是
browser_options.timezone_id	string	否	时区 ID（例如，'America/New_York'、'Europe/London'）
browser_options.color_scheme	enum	否	模拟的配色方案。默认值：lightlight \| dark \| no-preference
browser_options.user_data_dir	string	否	用于持久化配置文件的 Chrome 用户数据目录。会在会话之间缓存扩展程序状态、Google OAuth 会话和 chrome.storage.local 数据。如果省略，则会创建一个新的临时配置文件，并在关闭时清理。
browser_options.record_evidence	boolean	否	启用视频和跟踪记录。验证功能或错误修复时设为 true，以便用户查看录制内容并检查跟踪记录。
browser_options.disable_security	boolean	否	禁用 Web 安全机制（CORS、CSP）。默认值：false
browser_options.path_to_extension	string	否	未打包的 Chrome 扩展程序目录路径。使用 --load-extension 启动持久化 Chromium 上下文（无头 Chrome 无法加载扩展程序，因此会强制使用有头模式）。参见：https://playwright.dev/docs/chrome-extensions
storage_state_path	string	否	用于将 Cookie、localStorage 和 IndexedDB 恢复到会话中的存储状态文件路径。