stealth-browser-mcp

环境要求

• Python 3.10 或更高版本
• 已安装 Chrome、Chromium 或 Microsoft Edge 浏览器
• 支持 MCP 的 AI 客户端（如 Claude 等，可通过 env 块配置）
• 操作系统需支持 Python 虚拟环境（README 给出 Windows PowerShell 示例）

安装与启动步骤

1. 1克隆仓库

   把项目下载到本地并进入项目目录，之后所有命令都在该目录内执行。

   git clone https://github.com/vibheksoni/stealth-browser-mcp.git
   cd stealth-browser-mcp

   复制

2. 2创建虚拟环境

   README 的 Quickstart 用 venv 隔离依赖；后续请在该虚拟环境中运行服务。

   python -m venv venv

   复制

3. 3设置环境变量

   按需设置鉴权令牌、空闲超时、文件上传目录等；Windows 路径用分号分隔。

   $env:STEALTH_BROWSER_MCP_AUTH_TOKEN='replace-with-a-long-random-token'
   $env:BROWSER_IDLE_TIMEOUT='900'
   $env:BROWSER_IDLE_REAPER_INTERVAL='30'
   $env:BROWSER_ORPHAN_PROFILE_MAX_AGE='43200'
   $env:BROWSER_FILE_UPLOAD_ALLOWED_DIRS='C:\Users\me\uploads;C:\Users\me\Documents'

   复制

4. 4启动 MCP 服务器

   用项目内的 src/server.py 启动服务；未传 --port 时默认使用 8000 端口。

   python src/server.py

   复制

5. 5接入 MCP 客户端

   在 MCP 客户端配置中把 command 指向虚拟环境 python，args 指向 server.py，并填入 env。

   {
     "mcpServers": {
       "stealth-browser-mcp": {
         "command": "C:\\path\\to\\stealth-browser-mcp\\venv\\Scripts\\python.exe",
         "args": ["C:\\path\\to\\stealth-browser-mcp\\src\\server.py"],
         "env": {
           "STEALTH_BROWSER_MCP_AUTH_TOKEN": "replace-with-a-long-random-token",
           "BROWSER_IDLE_TIMEOUT": "900",
           "BROWSER_FILE_UPLOAD_ALLOWED_DIRS": "C:\\Users\\me\\uploads;C:\\Users\\me\\Documents"
         }
       }
     }
   }

   复制

6. 6HTTP 客户端连接

   如用 HTTP 传输，连接 http://127.0.0.1:8000/mcp/ 并带上 Bearer 令牌。

   from fastmcp import Client
   from fastmcp.client.auth import BearerAuth
   
   client = Client(
       "http://127.0.0.1:8000/mcp/",
       auth=BearerAuth("replace-with-a-long-random-token"),
   )

   复制

关键配置

如何确认成功

服务启动后默认监听 8000 端口，可用 HTTP 客户端连接 http://127.0.0.1:8000/mcp/ 并携带 Bearer 令牌确认连通。

常见问题

注意事项

• README 节选中的 Quickstart 在创建虚拟环境后即被截断，依赖安装命令未给出，请以仓库实际文件（如 requirements 等）为准，不要凭猜测执行。
• 配置中的 Windows 路径 C:\path\to\... 和 C:\Users\me\... 均为示例，需替换为自己机器上的真实路径。
• 启用令牌鉴权后，MCP 客户端与 HTTP 客户端都必须带上同一令牌，否则无法连接。
• 若要临时关闭 cdp-functions 相关能力，可设置 XPOOL_SAFE_MODE=1（启动时禁用该节）；调试日志可设 STEALTH_BROWSER_DEBUG=1。