Selenium-MCP-Python(注:这里的“MCP”可能是一个特定上下文或项目中的缩写,没有直接的中文对应,因此在翻译中保留原样,具体含义需根据上下文确定)
一个用于构建你自己的Selenium MCP的最小Python项目框架。
开始入门
- 创建并激活虚拟环境
- macOS/Linux: - python3 -m venv .venv - source .venv/bin/activate
- 安装依赖项
- pip install -e . 或者 pip install -r requirements.txt)
- 运行测试
- pytest
使用方法
- 以stdio模式运行MCP服务器(默认):
- python src/selenium_mcp_server.py - 对于HTTP(服务器发送事件)模式: python src/selenium_mcp_server.py --http
使用Claude桌面版(MCP)进行配置
- 确保这个项目在本地可以运行(参见上方的“入门指南”)。可选步骤:设置
.env。 - 打开Claude桌面版 → 设置 → 模型上下文协议 (MCP) → 添加服务器。
- 配置新服务器:
- 命令: python - 参数: src/selenium_mcp_server.py - 交通: stdio (默认) - 工作目录:此项目的仓库根目录
- 保存。现在你应该能看到像这样的工具
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+
______________________________________________________________________
