Selenix-MCP-Server

Selenix MCP 服务

通过 Model Context Protocol 将 Claude Desktop 连接到 Selenix。与 Claude 对话，即可创建、运行、调试和管理浏览器自动化测试——就像使用内置 AI 助手一样，但由 Claude 提供支持。

前置要求

• 已安装 Selenix 桌面应用
• 已安装 Claude Desktop
• Node.js 18 或更高版本

在 Selenix 中启用 Bridge

使用以下任一配置方式之前，请先在 Selenix 中启用 Bridge：

1. 打开 Selenix
2. 前往 System Settings（侧边栏中的齿轮图标）
3. 滚动到 MCP Server 部分
4. 将 Enable MCP Server 设为 Yes

这会启动本地 Bridge 服务，MCP 服务将连接到该服务。

配置

选择以下任一种方式：

选项 A：通过 npm 安装（推荐）

npm install -g @selenix/mcp-server

然后找到全局 npm 路径：

npm root -g

打开 Claude Desktop 配置文件：

• Windows：按 Win+R，粘贴 %APPDATA%\Claude\claude_desktop_config.json，然后按 Enter
• macOS：打开 ~/Library/Application Support/Claude/claude_desktop_config.json

添加 Selenix MCP 服务，并将路径替换为 npm root -g 的输出：

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["<npm-root-path>/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

示例（使用 nvm 的 Windows）：

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/Users/YourName/AppData/Local/nvm/v18.20.8/node_modules/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

示例（macOS/Linux）：

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["/usr/local/lib/node_modules/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

如果已配置其他 MCP 服务，请在现有的 "mcpServers" 对象中添加 "selenix"。

选项 B：使用捆绑版本（无需 npm）

如果你将 Selenix 安装为桌面应用，MCP 服务已随应用捆绑。无需安装任何内容，只需让 Claude Desktop 指向捆绑文件即可。

找到 Selenix 的安装文件夹，并查找 resources/mcp-server/index.js，然后将其添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/path/to/Selenix/resources/mcp-server/index.js"]
    }
  }
}

Windows 常见路径：

C:/Users/YourName/AppData/Local/Programs/Selenix/resources/mcp-server/index.js

选项 C：手动下载

1. 从 npm 软件包页面或 发布页面下载 bundle.js
2. 将其保存在计算机上的某个位置（例如，C:/selenix-mcp/bundle.js）
3. 将其添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/selenix-mcp/bundle.js"]
    }
  }
}

仍然需要 Node.js——MCP 服务是一个不依赖其他内容的独立 JavaScript 文件。

验证

编辑配置后，重启 Claude Desktop。你应该会在聊天输入区域看到 Selenix 工具图标（锤子）。

试着向 Claude 提问：

• “我的 Selenix 项目中有哪些测试？”
• “创建一个测试，打开 google.com 并搜索 ‘selenium automation’”
• “运行当前测试并修复所有失败项”
• “截取浏览器的屏幕截图”

工作原理

Claude Desktop <--stdio--> MCP Server <--HTTP--> Bridge Server (inside Selenix)

MCP 服务会将 Claude 的工具调用转换为发送到 Selenix 内部 Bridge 服务的 HTTP 请求。Bridge 可完全访问 Selenix 内部功能——与内置 AI 助手具备相同的能力。

• Bridge 仅侦听 127.0.0.1（localhost），不会暴露到网络
• 身份验证通过 bearer token 处理，该令牌会在每次 Selenix 启动时自动生成
• 连接配置存储在 ~/.selenix/bridge.json 中，并在每次调用时重新读取，因此重启 Selenix 后无需重启 Claude Desktop

可用工具

读取与检查

工具	说明
get_screenshot	截取浏览器窗口的屏幕截图
get_page_html	获取带交互元素注释的页面 HTML
get_search_html	按正则表达式搜索页面 HTML
get_selected_command_info	获取命令目标元素的 DOM 上下文
get_current_test	获取当前测试中的所有命令
get_test_list	列出项目中的所有测试
get_test_by_name	按名称获取测试
get_command_list	列出所有可用的 Selenix 命令
get_command_info	获取特定命令的详细文档
get_project_info	获取项目元数据
get_active_suite	获取当前活动的测试套件
get_step_results	获取上次测试运行的通过／失败结果
get_logs	获取近期日志（所有类型），每页 20 条，按时间从近到远排序。可选的 page 参数用于分页。
get_workspace_context	获取当前工作区摘要

编写与执行

工具	说明
add_commands	在指定位置向测试中添加命令
run_test	运行测试并等待结果（最长 2 分钟）
clear_and_replace_commands	替换测试中的所有命令
fix_commands	应用有针对性的修复 — 更新、删除或插入命令

故障排除

“无法读取 Selenix bridge 配置” Selenix 未运行，或 MCP Server 未启用。打开 Selenix → System Settings → 将 Enable MCP Server 设置为 Yes。

“无法连接到 Selenix bridge” Selenix 可能刚刚重启。请重试请求 — MCP 服务会自动获取新的连接详情。

Claude Desktop 中未显示工具 请确保编辑配置文件后重启了 Claude Desktop。确认配置 JSON 有效（没有尾随逗号，括号正确）。

更改配置后 Claude Desktop 无法打开 配置 JSON 可能格式错误。请在文本编辑器中打开配置文件，修正 JSON 语法，然后重试。常见问题：条目之间缺少逗号，或最后一个条目后有尾随逗号。

卸载

npm uninstall -g @selenix/mcp-server

然后从 Claude Desktop 配置文件中移除 "selenix" 条目，并重启 Claude Desktop。