AI导哈

Selenium MCP Python脚手架

一个用于构建自定义Selenium MCP的最小化Python项目脚手架，支持通过Claude Desktop进行浏览器自动化操作。

  • by rishabhsakhare17
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 rishabhsakhare17/selenium-mcp-python

使用说明

Selenium-MCP-Python（注：这里的“MCP”可能是一个特定上下文或项目中的缩写，没有直接的中文对应，因此在翻译中保留原样，具体含义需根据上下文确定）

一个用于构建你自己的Selenium MCP的最小Python项目框架。

开始入门

  1. 创建并激活虚拟环境
    • macOS/Linux：
      • python3 -m venv .venv
      • source .venv/bin/activate
  2. 安装依赖项
    • pip install -e . 或者 pip install -r requirements.txt)
  3. 运行测试
    • pytest

使用方法

  • 以stdio模式运行MCP服务器（默认）：
    • python src/selenium_mcp_server.py
    • 对于HTTP（服务器发送事件）模式： python src/selenium_mcp_server.py --http

使用Claude桌面版（MCP）进行配置

  1. 确保这个项目在本地可以运行（参见上方的“入门指南”）。可选步骤：设置 .env。
  2. 打开Claude桌面版 → 设置 → 模型上下文协议 (MCP) → 添加服务器。
  3. 配置新服务器：
    • 命令： python
    • 参数： src/selenium_mcp_server.py
    • 交通： stdio （默认）
    • 工作目录：此项目的仓库根目录
  4. 保存。现在你应该能看到像这样的工具 open_browser， go_to_url， click_element， get_page_text， screenshot， close_browser 在Claude的工具面板中可用。

注释：

  • 如果未找到Chrome/Chromedriver，请安装Chrome并确保安装一个兼容的驱动程序（在较新版本的Selenium中，Selenium Manager通常会自动处理此操作）。
  • 如果你更倾向于使用HTTP/SSE而不是stdio，请运行服务器时使用 --http 如果/当Claude支持MCP的HTTP传输时，请将Claude指向您的HTTP终端点。目前推荐使用标准输入输出（Stdio）。

Claude Desktop mcpServers JSON（中文翻译）：Claude 桌面版 mcpServers JSON

将以下内容粘贴到您的Claude桌面MCP配置中：

{
  "mcpServers": {
    "selenium-mcp": {
      "command": "python",
      "args": ["src/selenium_mcp_server.py"],
      "env": {
        "MCP_HEADLESS": "1",
        "MCP_HTTP_PORT": "5003"
      }
    }
  }
}

如果Claude启动时您的仓库不是当前工作目录，请指定一个绝对工作目录：

"workingDirectory": "/absolute/path/to/selenium-mcp-python"

项目布局

  • src/selenium_mcp/源代码包
  • tests/测试套件
  • pyproject.toml构建和打包元数据
  • requirements.txt运行时/开发时依赖（镜像 pyproject.toml （依赖项）deps

备注

  • 目标 Python 版本：3.10+

相关 MCP