DrissionPage MCP Server

Professional browser automation for Claude Code and MCP clients powered by DrissionPage

Official Repositories: GitHub | GitCode

English Version | 中文版本

🚀 What is DrissionPage MCP?

DrissionPage MCP Server is a production-ready Model Context Protocol (MCP) server that brings professional browser automation capabilities to Claude Code, Claude Desktop, and other MCP clients.

Unlike screenshot-based approaches, it provides structured, deterministic web automation through 14 powerful tools that leverage the efficiency of DrissionPage, a high-performance browser automation framework.

🌟 Why Choose DrissionPage MCP?

• LLM-Optimized: Works with structured data instead of requiring vision models

• Deterministic: Reliable element selection with CSS and XPath support

• Fast & Lightweight: Built on DrissionPage's efficient engine with minimal overhead

• Type-Safe: Full type hints and Pydantic validation for all tools

• Production Ready: Thoroughly tested and documented, ready for real-world use

• Easy Integration: Simple pip install + JSON configuration

⚡ Quick Install

📦 Setup in Claude Code (30 seconds)

1. Edit MCP configuration:

   • macOS/Linux: ~/.config/claude-code/mcp_settings.json

   • Windows: %APPDATA%\claude-code\mcp_settings.json

2. Add this configuration:

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

3. Restart Claude Code and start using!

🎯 Quick Examples

Navigate and Screenshot

Search and Extract

Form Automation

Data Scraping

🛠️ 14 Powerful Tools

🌐 Navigation (4 tools)

• page_navigate - Navigate to any URL

• page_go_back / page_go_forward - Browser history

• page_refresh - Reload current page

🎯 Element Interaction (3 tools)

• element_find - Find elements by CSS selector or XPath

• element_click - Click any element

• element_type - Input text into elements

📸 Page Operations (5 tools)

• page_screenshot - Capture full page or viewport

• page_resize - Adjust browser window

• page_click_xy - Click by coordinates

• page_close - Close browser

• page_get_url - Get current URL

⏱️ Wait Operations (2 tools)

• wait_for_element - Wait for element to appear (with timeout)

• wait_time - Delay execution

📚 Documentation

🏗️ Architecture

Built with clean, modular design:

Key Principles:

• ✅ Type-safe Pydantic models for all tools

• ✅ Async/await throughout

• ✅ Clean separation of concerns

• ✅ Comprehensive error handling

• ✅ Full test coverage

🔧 Configuration

Basic Setup (Recommended)

Advanced Setup

See examples/README.md for more configuration options.

📋 Requirements

• Python 3.8+ (3.11+ recommended)

• Chrome or Chromium browser

• Any MCP-compatible client: Claude Code, Claude Desktop, Cursor, VS Code, etc.

🧪 Testing

Verify Installation

Try It Out

🚀 Use Cases

✅ Automated Testing - Test web applications ✅ Data Scraping - Extract structured data from websites ✅ Form Automation - Fill and submit forms ✅ Monitoring - Check for updates or changes ✅ Screenshot Verification - Capture and verify page state ✅ Content Analysis - Analyze web content programmatically

🐛 Troubleshooting

Tools Not Loading?

Should output: drissionpage-mcp 0.1.0

Browser Issues?

Claude Code Not Finding Server?

• Verify config file path

• Restart Claude Code after changes

• Check logs: drissionpage-mcp --log-level DEBUG

See TESTING_AND_INTEGRATION.md for complete troubleshooting guide.

📊 Project Status

Version: 0.1.0 | License: Apache 2.0 | Maintained: ✅ Active

🗺️ Roadmap

Current (v0.1.0)

• 14 core automation tools

• Full MCP protocol support

• Production-ready codebase

• Comprehensive documentation

• PyPI distribution

Future (v0.2+)

• Form handling utilities

• File upload support

• Shadow DOM selectors

• Session persistence

• Proxy support

• Network interception

📖 Integration Examples

Claude Code

Claude Desktop

See examples/ for more client configurations.

🤝 Contributing

Contributions are welcome!

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests if needed

5. Submit a pull request

🔒 Security

• Does not store or transmit sensitive data

• Runs locally in your environment

• No external API calls

• Respects website terms of service

Best Practices:

• Don't automate without permission

• Use on test environments when possible

• Respect robots.txt

• Add appropriate delays between actions

📄 License

Licensed under Apache License 2.0 - see LICENSE

🙏 Acknowledgments

• DrissionPage - Excellent browser automation library

• Model Context Protocol - Protocol specification

• Claude - Making AI assistants capable and useful

💬 Support

• 📖 Full Documentation

• 🐛 Report Issues

• 💡 Feature Requests

• 🔗 GitHub Repository

• 📦 PyPI Package

📈 Statistics

🌟 Show Your Support

If you find this project useful, please consider:

• ⭐ Starring on GitHub

• 📤 Sharing with your network

• 💬 Leaving feedback or suggestions

• 🐛 Reporting issues to help improve

Made with ❤️ by

Ready to automate your workflows? Install now: pip install drissionpage-mcp