Selenium MCP Appstore

selenium-mcp（ChatGPT应用程序/mcp服务器）

A. 模型上下文协议（MCP） 提供以下功能的服务器 基于会话的Selenium浏览器自动化 超过 流式HTTP.

部署时，ChatGPT（或任何MCP客户端）连接到：

• https:///mcp

这次“商店准备就绪”的清理发生了什么变化

此仓库最初包含一个具有自定义端点的FastAPI垫片，如 /mcp/schema 和 /mcp/invoke. 对于Apps SDK/现代MCP客户端，您需要 真实MCP服务器.

此回购现在包括 mcp_server_v2.py，建立在 官方MCP Python SDK（FastMCP）.

暴露的工具

所有工具都是 基于会话 （创建一次会话，然后在同一浏览器中执行多个步骤）：

• create_session() → { session_id }
• open_page(session_id, url, wait_css?, timeout_s?)
• click(session_id, css_selector, timeout_s?)
• type_text(session_id, css_selector, text, clear_first?, timeout_s?)
• get_text(session_id, css_selector, timeout_s?)
• screenshot(session_id) → base64 PNG
• close_session(session_id)
• reap_idle_sessions(max_idle_seconds?)

在本地运行

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Runs Streamable HTTP MCP at http://localhost:8000/mcp
python mcp_server_v2.py

可选环境变量：

• PORT （默认值 8000)
• HOST （默认值 0.0.0.0)
• CHROME_BINARY （如果Chrome不在PATH上）
• CHROMEDRIVER_PATH （如果镀铬层不在PATH上）

部署

部署在HTTPS后面（渲染/飞行/铁路/云运行）。这 MCP端点必须稳定:

• https:///mcp

此回购包括 Procfile 它运行：

• python mcp_server_v2.py

注意：对于生产环境，请在容器/运行时中安装Chrome+chromedriver。

如何测试（冒烟）

此repo包括一个基于curl的MCP烟雾测试，该测试：

• 初始化MCP会话
• 列出工具
• 创建Selenium浏览器会话
• 打开https://example.com，验证 h1
• 截图(smoke.png)
• 关闭浏览器会话

前提条件

• bash
• curl
• jq
• base64

跑

chmod +x smoke_mcp.sh
./smoke_mcp.sh