浏览器自动化工具

一个通过MCP服务器让AI模型控制本地Chrome浏览器与ChatGPT交互的工具,适用于需要最新ChatGPT版本或自动化工作流的场景。

  • by SAGAR-TAMANG
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 SAGAR-TAMANG/chatgpt-browser-mcp

使用说明

ChatGPT浏览器MCP

该项目提供了一个MCP(模型客户端协议)服务器,允许像Claude这样的AI模型控制本地Chrome浏览器与ChatGPT交互。它暴露了一个 run_chatgpt MCP客户端可以调用该工具,直接从ChatGPT web界面获取响应。

这对于需要与最新版本的ChatGPT交互的任务或在由AI代理控制的更大的自动化工作流中利用其功能非常有用。


🎥 视频教程

有关设置、配置和使用的完整演练,请观看下面的视频教程。


⚙️ 先决条件

在开始之前,请确保已安装以下内容:

  1. Python 3.8+
  2. 紫外线:一个非常快的Python包安装程序和解析器。
    # Install uv on macOS and Linux
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
    # Install uv on Windows
    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
    
  3. 谷歌浏览器:谷歌Chrome浏览器的标准安装。

🚀 设置和安装

按照以下步骤启动并运行服务器。

1.克隆存储库

首先,将此存储库克隆到本地计算机。

git clone https://github.com/SAGAR-TAMANG/chatgpt-browser-mcp.git
cd chatgpt-browser-mcp

2.安装依赖项

使用 uv 创建虚拟环境并安装所需的Python包。如果你没有紫外线,请安装它。

# Create and activate a virtual environment
uv venv
.venv\Scripts\activate

# Install dependencies
uv pip install .

3.配置文件路径

这是最重要的一步。你 必须 编辑 main.py 文件指向您的本地Chrome安装和用户配置文件。

打开 main.py 并修改以下配置变量:

# --- Config ---

# ⚠️ UPDATE THIS: Path to your Google Chrome executable
browser_1 = "C:/Program Files/Google/Chrome/Application/chrome.exe"

# ⚠️ UPDATE THIS: Path to a directory for user data.
# Using a temporary or secondary profile is recommended.
profile_dir = "C:/Users/YOUR_USERNAME/Documents/MyChromeProfile"

# ⚠️ UPDATE THIS: The name of the profile to use within the profile_dir.
profile_name = "Profile 1"

如何找到这些路径:

  • browser_1 (Chrome可执行文件):
    • 视窗:通常 C:/Program Files/Google/Chrome/Application/chrome.exe.
    • macOS: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome.
  • profile_dir & profile_name:
    • 通过导航到以下位置查找您的Chrome个人资料路径 chrome://version 在浏览器中查找“配置文件路径”字段。
    • 强烈建议为创建一个新的单独文件夹 profile_dir 以避免干扰您的主浏览器配置文件。

[!小心] 最新Chrome版本 需要 您可以创建profiledir的单独副本。


🔌 连接到Claude桌面客户端

服务器运行后,您可以连接到Claude MCP客户端。

uv run mcp install main.py

这将把此MCP添加到克劳德桌面应用程序的claude_desktop_config.json中。

然后将其添加到claude_desktop_config.json的参数中:

"--python",
"C:\\Path\\To\\Your\\Venv\\Scripts\\activate.bat",

⚠️ 重要提示

  • 脆弱的自动化:此工具依赖于固定 asyncio.sleep() 计时器和在ChatGPT网站上查找UI元素。如果ChatGPT更新其用户界面,此脚本可能会中断并需要更新。
  • 剪贴板使用情况:通过单击“复制”按钮并通过以下方式从系统剪贴板读取来检索响应 pyperclip。这意味着,如果在工具运行时复制其他文本,可能会干扰结果。
  • 安全:该工具控制一个可能登录到您个人帐户的浏览器。请注意允许脚本具有这种访问级别的安全影响。

📄 许可证

该项目根据 MIT许可证。请参阅 LICENSE 文件以获取更多详细信息。