DrissionPage MCP Server

DrissionPage MCP服务器

由DrissionPage提供支持的Claude Code和MCP客户端的专业浏览器自动化

 ](https://pepy.tech/project/drissionpage-mcp)  ](https://www.python.org/downloads/) 

官方存储库: | Gitcode：

英文版本 | 中文版本

______________________________________________________________________

🚀 什么是DrissionPage MCP？

DrissionPage MCP服务器 是一个生产就绪的模型上下文协议（MCP）服务器，为Claude Code、Claude Desktop和其他MCP客户端带来了专业的浏览器自动化功能。

与基于屏幕截图的方法不同，它提供 结构化、确定性的web自动化 通过14个强大的工具，利用 钻井页面，一个高性能的浏览器自动化框架。

🌟 为什么选择DrissionPage MCP？

• LLM优化：使用结构化数据，而不需要视觉模型
• 确定性的：可靠的元素选择，支持CSS和XPath
• 快速轻便：基于DrissionPage的高效引擎，开销最小
• 类型安全：所有工具的完整类型提示和Pydantic验证
• 生产就绪：经过彻底测试和记录，可供实际使用
• 轻松集成：简单 pip install +JSON配置

______________________________________________________________________

⚡ 快速安装

# Install from PyPI
pip install drissionpage-mcp

# Verify installation
drissionpage-mcp --version

______________________________________________________________________

📦 克劳德代码设置（30秒）

1. 编辑MCP配置:

- macOS/Linux： ~/.config/claude-code/mcp_settings.json - 窗户： %APPDATA%\claude-code\mcp_settings.json

1. 添加此配置:

   {
     "mcpServers": {
       "drissionpage": {
         "command": "drissionpage-mcp"
       }
     }
   }

1. 重新启动Claude代码 并开始使用！

______________________________________________________________________

🎯 快速示例

导航和屏幕截图

"Visit https://example.com and take a screenshot for me"

搜索和提取

"Go to Wikipedia, search for Python, and get the first paragraph"

表单自动化

"Fill out the form at https://httpbin.org/forms/post and submit it"

数据抓取

"Get the top 10 news headlines from news.ycombinator.com"

______________________________________________________________________

🛠️ 14强大的工具

🌐 导航（4个工具）

• page_navigate -导航到任何URL
• page_go_back / page_go_forward -浏览器历史记录
• page_refresh -重新加载当前页面

🎯 元素交互（3个工具）

• element_find -通过CSS选择器或XPath查找元素
• element_click -单击任何元素
• element_type -在元素中输入文本

📸 页面操作（5个工具）

• page_screenshot -捕获整个页面或视口
• page_resize -调整浏览器窗口
• page_click_xy -按坐标单击
• page_close -关闭浏览器
• page_get_url -获取当前URL

⏱️ 等待操作（2个工具）

• wait_for_element -等待元素出现（超时）
• wait_time -延迟执行

______________________________________________________________________

📚 文档

______________________________________________________________________

🏗️ 建筑

建于 简洁、模块化设计:

DrissionMCP/
├── src/
│   ├── cli.py              # Entry point
│   ├── server.py           # MCP server
│   ├── context.py          # Browser management
│   ├── response.py         # Response formatting
│   ├── tab.py              # Page operations
│   └── tools/              # 14 automation tools
├── examples/               # Configuration templates
├── tests/                  # Unit tests
└── playground/             # Testing utilities

关键原则:

• ✅ 适用于所有工具的类型安全Pydantic模型
• ✅ 始终异步/等待
• ✅ 清晰地分离关注点
• ✅ 全面的错误处理
• ✅ 全面测试覆盖

______________________________________________________________________

🔧 配置

基本设置（推荐）

{
  "mcpServers": {
    "drissionpage": {
      "command": "drissionpage-mcp"
    }
  }
}

高级设置

{
  "mcpServers": {
    "drissionpage": {
      "command": "drissionpage-mcp",
      "args": ["--log-level", "DEBUG"],
      "env": {
        "CHROME_PATH": "/custom/path/to/chrome"
      }
    }
  }
}

看 示例/README.md 更多配置选项。

______________________________________________________________________

📋 需求

• Python 3.8+ （3.11+推荐）
• 铬或铬 浏览器
• 任何兼容MCP的客户端：克劳德代码、克劳德桌面、光标、VS代码等。

______________________________________________________________________

🧪 测试

验证安装

# Quick verification
python -c "from DrissionPage import ChromiumPage; p = ChromiumPage(); print('✅ Ready')"

# Or run tests
pip install -e ".[dev]"
pytest tests/

试试看

# Interactive testing
python playground/local_test.py

# Quick start validation
python playground/quick_start.py

______________________________________________________________________

🚀 用例

✅ 自动化测试 -测试web应用程序 ✅ 数据抓取 -从网站中提取结构化数据 ✅ 表单自动化 -填写并提交表格 ✅ 监控 -检查更新或更改 ✅ 屏幕截图验证 -捕获并验证页面状态 ✅ 内容分析 -以编程方式分析web内容

______________________________________________________________________

🐛 故障排除

工具未加载？

drissionpage-mcp --version

应输出： drissionpage-mcp 0.1.0

浏览器问题？

# Check browser installation
which google-chrome    # Linux
which chromium         # macOS

克劳德代码找不到服务器？

• 验证配置文件路径
• 更改后重新启动Claude代码
• 检查日志： drissionpage-mcp --log-level DEBUG

看 测试\_ ND_INTEGRATION.md 获取完整的故障排除指南。

______________________________________________________________________

📊 项目状态

版本: 0.1.0 | 许可证：Apache 2.0| 维护: ✅ 活跃的

______________________________________________________________________

🗺️ 路线图

电流（v0.1.0）

• \[x\] 14个核心自动化工具
• \[x\] 完全支持MCP协议
• \[x\] 生产就绪代码库
• \[x\] 全面的文件
• \[x\] PyPI分布

未来（v0.2+）

• \[\]表单处理实用程序
• \[\]文件上传支持
• \[\]影子DOM选择器
• \[\]会话持久性
• \[\]代理支持
• \[\]网络拦截

______________________________________________________________________

📖 集成示例

克劳德代码

{
  "mcpServers": {
    "drissionpage": {
      "command": "drissionpage-mcp"
    }
  }
}

克劳德桌面

{
  "mcpServers": {
    "drissionpage": {
      "command": "drissionpage-mcp"
    }
  }
}

看 示例/ 更多客户端配置。

______________________________________________________________________

🤝 贡献

欢迎投稿！

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果需要，添加测试
5. 提交拉取请求

______________________________________________________________________

🔒 安全

• 不存储或传输敏感数据
• 在您的环境中本地运行
• 没有外部API调用
• 尊重网站服务条款

最佳实践:

• 未经许可，请勿自动化
• 尽可能在测试环境中使用
• 尊重robots.txt
• 在操作之间添加适当的延迟

______________________________________________________________________

📄 许可证

根据以下许可 Apache许可证2.0 -看 许可证

______________________________________________________________________

🙏 致谢

• 钻井页面 -优秀的浏览器自动化库
• 模型上下文协议 -协议规范
• 克劳德 -让AI助手变得有能力和有用

______________________________________________________________________

💬 支持

• 📖 全部文件
• 🐛 报告问题
• 💡 功能请求
• 🔗 ****
• 📦 PyPI包

______________________________________________________________________

📈 统计

](https://pepy.tech/project/drissionpage-mcp) ](https://pypi.org/project/drissionpage-mcp/)

______________________________________________________________________

🌟 表示支持

如果你觉得这个项目有用，请考虑：

• ⭐ 主演
• 📤 与您的网络共享
• 💬 留下反馈或建议
• 🐛 报告问题以帮助改进

______________________________________________________________________

由...制作❤️ 通过 吴坤云

准备好自动化您的工作流程了吗？ 立即安装： pip install drissionpage-mcp