DrissionPage-MCP-Server

基于 DrissionPage 的模型上下文协议 (MCP) 服务，为 AI 助手提供强大的浏览器自动化能力。

✨ 核心特性

🌐 浏览器自动化 - 页面导航、元素操作、截图等完整功能
🔧 MCP协议支持 - 与AI助手无缝集成的标准化接口
📸 截图与DOM - 页面分析、元素定位、结构获取
🚀 异步高性能 - 基于FastMCP框架的高效服务
🛠️ 17工具集 - 涵盖浏览器管理到文件处理的全方位功能

🚀 快速开始

安装

bash

# 克隆项目
git clone https://github.com/persist-1/DrissionPage-MCP-Server.git
cd DrissionPage-MCP-Server/

# 安装依赖
pip install -e .
# 或使用 uv（推荐）
uv sync

启动服务

bash

# 启动MCP服务（STDIO模式）
drissionpage-mcp

在AI助手中配置

在 Trae AI IDE 中添加 MCP 服务配置：

json

   {
      "mcpServers": {
         "drissionpage-mcp": {
            "command": "Yourpath\\DrissionPage-MCP-Server\\.venv\\Scripts\\python.exe",
            "args": [
            "-m",
            "drissionpage_mcp.main"
            ],
            "env": {
            "PYTHONPATH": "Yourpath\\DrissionPage-MCP-Server\\src"
            }
         }
      }
   }

MCP配置效果

📱 使用案例

网页自动化操作

复杂页面交互

基本使用示例

python

# 连接浏览器
result = await connect_browser(port=9222, headless=False)

# 导航并截图
result = await navigate("https://example.com")
result = await take_screenshot("page.png")

# 元素操作
result = await click_element("#submit-button")
result = await input_text("#username", "your_username")

🛠️ MCP 工具列表

分类	工具	功能描述
🌐 浏览器管理	1.`connect_browser`	连接/启动浏览器
	2.`new_tab`	创建新标签页
	3.`navigate`	页面导航
🎯 元素操作	4.`click_element`	点击元素
	5.`input_text`	输入文本
	6.`get_element_text`	获取元素文本内容
	7.`get_page_text`	获取页面完整文本内容
📸 截图功能	8.`take_screenshot`	页面/元素截图
	9.`get_screenshot_data`	获取截图数据
🌳 DOM操作	10.`get_dom_tree`	获取DOM树结构
	11.`find_elements`	查找页面元素
🔍 网络监控	12.`enable_network_monitoring`	启用网络监控
	13.`get_network_logs`	获取网络日志
📁 文件操作	14.`save_page_source`	保存页面源码
	15.`get_cookies`	获取Cookies
⚡ 高级功能	16.`execute_javascript`	执行JavaScript
	17.`run_cdp_command`	执行CDP命令

⚙️ 环境配置

bash

# 基本配置
export DRISSIONPAGE_MCP_LOG_LEVEL=INFO
export DRISSIONPAGE_MCP_HEADLESS=false
export DRISSIONPAGE_MCP_TIMEOUT=30

# 路径配置（可选）
export DRISSIONPAGE_MCP_BROWSER_PATH=/path/to/chrome
export DRISSIONPAGE_MCP_DOWNLOAD_PATH=/path/to/downloads
export DRISSIONPAGE_MCP_SCREENSHOT_PATH=/path/to/screenshots

🏗️ 项目架构

整体架构图

DrissionPage-MCP-Server/
├── .github/                    # GitHub 配置
│   ├── ISSUE_TEMPLATE/         # Issue 模板
│   │   ├── bug_report.md       # Bug 报告模板
│   │   └── quesiton.md         # 问题咨询模板
│   └── workflows/              # GitHub Actions 工作流
│       └── deploy.yml          # VitePress 文档自动部署
├── browsers/                   # 浏览器相关文件
│   ├── chrome-portable/        # 便携版 Chrome 浏览器
│   └── readme_please.md        # 浏览器使用说明
├── docs/                       # 文档目录
│   ├── site_config/            # VitePress 文档站点
│   │   ├── .vitepress/         # VitePress 配置目录
│   │   │   ├── config.mts      # 站点配置文件
│   │   │   └── dist/           # 构建输出目录
│   │   ├── public/             # 静态资源目录
│   │   │   └── images/         # 图片资源
│   │   ├── README.md           # 文档首页
│   │   ├── instruction.md      # 使用说明
│   │   ├── api-reference.md    # API 参考
│   │   ├── architecture.md     # 架构文档
│   │   ├── faq.md             # 常见问题
│   │   ├── mcp-tools.md       # MCP 工具说明
│   │   └── index.md           # VitePress 首页配置
│   ├── package.json           # 文档站点依赖配置
│   ├── package-lock.json      # 依赖锁定文件
│   └── ds_run_dev.bat         # 开发启动脚本
├── src/                        # 源代码目录
│   └── drissionpage_mcp/       # 主要代码包
│       ├── config/             # 配置模块
│       │   ├── __init__.py
│       │   └── settings.py     # 环境配置和设置
│       ├── core/               # 核心功能模块
│       │   ├── __init__.py
│       │   ├── browser_manager.py    # 浏览器管理器
│       │   ├── element_handler.py    # 元素操作处理器
│       │   ├── file_handler.py       # 文件操作处理器
│       │   └── network_listener.py   # 网络监听器
│       ├── services/           # 服务层
│       │   ├── __init__.py
│       │   ├── cdp_service.py        # Chrome DevTools 协议服务
│       │   ├── dom_service.py        # DOM 操作服务
│       │   └── screenshot_service.py # 截图服务
│       ├── utils/              # 工具模块
│       │   ├── __init__.py
│       │   ├── helpers.py            # 辅助函数
│       │   └── text_matcher.py      # 文本匹配工具
│       ├── __init__.py         # 包初始化文件
│       └── main.py             # MCP 服务入口点
├── tests/                      # 测试目录
│   ├── integration/            # 集成测试
│   ├── __init__.py
│   ├── check_browser.py        # 浏览器检查脚本
│   └── local_build_test.ps1    # 本地构建测试
├── pyproject.toml              # Python 项目配置
├── requirements.txt            # 生产环境依赖
├── requirements-dev.txt        # 开发环境依赖
├── pytest.ini                 # 测试配置
├── .gitignore                  # Git 忽略规则
└── uv.lock                     # UV 包管理器锁定文件

核心模块说明

🔧 配置层 (config/)

settings.py: 管理环境变量、浏览器路径、超时设置等配置项

🏗️ 核心层 (core/)

browser_manager.py: 浏览器生命周期管理，包括启动、连接、标签页操作
element_handler.py: 页面元素的查找、点击、输入、获取文本等操作
file_handler.py: 文件系统操作，包括保存页面源码、管理下载文件
network_listener.py: 网络请求监听和日志记录

🚀 服务层 (services/)

cdp_service.py: Chrome DevTools 协议的封装和调用
dom_service.py: DOM 树获取、解析和操作
screenshot_service.py: 页面和元素截图功能

🛠️ 工具层 (utils/)

helpers.py: 通用辅助函数和工具方法
text_matcher.py: 文本匹配和处理算法

技术架构

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   AI 助手       │◄──►│  MCP 协议服务     │◄──►│  Chrome 浏览器   │
│  (Trae AI)     │    │  (main.py)      │    │  (DrissionPage) │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                    ┌──────────────────┐
                    │    服务层         │
                    │  ┌─────────────┐  │
                    │  │ CDP Service │  │
                    │  │ DOM Service │  │
                    │  │Screenshot   │  │
                    │  └─────────────┘  │
                    └──────────────────┘
                              │
                              ▼
                    ┌──────────────────┐
                    │    核心层         │
                    │  ┌─────────────┐  │
                    │  │Browser Mgr  │  │
                    │  │Element Hand │  │
                    │  │File Handler │  │
                    │  │Network List │  │
                    │  └─────────────┘  │
                    └──────────────────┘

📚 文档

📖 在线文档 - 完整的项目文档
🚀 使用说明 - 快速上手指南
🏗️ 开发指南 - 开发环境配置
🔧 项目架构 - 架构设计说明
📋 API参考 - 详细API文档

🔧 故障排除

问题	解决方案
🌐 浏览器连接失败	确保Chrome已安装，检查调试端口配置
🎯 元素找不到	检查选择器，等待页面加载，使用更具体选择器
📸 截图失败	检查磁盘空间、文件权限、截图目录
🔍 网络监控无数据	确保已启用监控，检查过滤条件

bash

# 启用调试日志
drissionpage-mcp --log-level DEBUG

🤝 贡献

欢迎提交 Issue 和 Pull Request！

Fork 项目 → 2. 创建分支 → 3. 提交更改 → 4. 推送分支 → 5. 创建 PR

📄 许可证

MIT License - 详见 LICENSE 文件

📖 参考项目

本项目基于 DrissionPage 构建

⭐ 如果这个项目对你有帮助，请给个 Star！

DrissionPage-MCP-Server ​

✨ 核心特性 ​

🚀 快速开始 ​

安装 ​

启动服务 ​

在AI助手中配置 ​

📱 使用案例 ​

网页自动化操作 ​

复杂页面交互 ​

基本使用示例 ​

🛠️ MCP 工具列表 ​

⚙️ 环境配置 ​

🏗️ 项目架构 ​

整体架构图 ​

核心模块说明 ​

🔧 配置层 (config/) ​

🏗️ 核心层 (core/) ​

🚀 服务层 (services/) ​

🛠️ 工具层 (utils/) ​

技术架构 ​

📚 文档 ​

🔧 故障排除 ​

🤝 贡献 ​

📄 许可证 ​

📖 参考项目 ​

DrissionPage-MCP-Server

✨ 核心特性

🚀 快速开始

安装

启动服务

在AI助手中配置

📱 使用案例

网页自动化操作

复杂页面交互

基本使用示例

🛠️ MCP 工具列表

⚙️ 环境配置

🏗️ 项目架构

整体架构图

核心模块说明

🔧 配置层 (config/)

🏗️ 核心层 (core/)

🚀 服务层 (services/)

🛠️ 工具层 (utils/)

技术架构

📚 文档

🔧 故障排除

🤝 贡献

📄 许可证

📖 参考项目