loading…
Search for a command to run...
loading…
A professional browser automation server that enables MCP clients to perform structured web navigation, element interaction, and data extraction using the Driss
A professional browser automation server that enables MCP clients to perform structured web navigation, element interaction, and data extraction using the DrissionPage framework. It features 14 deterministic tools optimized for LLMs to automate web workflows efficiently without relying on vision-based models.
Professional browser automation for Claude Code and MCP clients powered by DrissionPage
PyPI Downloads License Python Version Status
Official Repositories: GitHub | GitCode
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.
pip install + JSON configuration# Install from PyPI
pip install drissionpage-mcp
# Verify installation
drissionpage-mcp --version
Edit MCP configuration:
~/.config/claude-code/mcp_settings.json%APPDATA%\claude-code\mcp_settings.jsonAdd this configuration:
{
"mcpServers": {
"drissionpage": {
"command": "drissionpage-mcp"
}
}
}
Restart Claude Code and start using!
"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"
page_navigate - Navigate to any URLpage_go_back / page_go_forward - Browser historypage_refresh - Reload current pageelement_find - Find elements by CSS selector or XPathelement_click - Click any elementelement_type - Input text into elementspage_screenshot - Capture full page or viewportpage_resize - Adjust browser windowpage_click_xy - Click by coordinatespage_close - Close browserpage_get_url - Get current URLwait_for_element - Wait for element to appear (with timeout)wait_time - Delay execution| Guide | Description |
|---|---|
| QUICKSTART.md | 5-minute setup guide |
| USAGE_GUIDE.md | Complete usage reference |
| TESTING_AND_INTEGRATION.md | Integration with MCP clients |
| examples/README.md | Configuration examples |
Built with clean, modular design:
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
Key Principles:
{
"mcpServers": {
"drissionpage": {
"command": "drissionpage-mcp"
}
}
}
{
"mcpServers": {
"drissionpage": {
"command": "drissionpage-mcp",
"args": ["--log-level", "DEBUG"],
"env": {
"CHROME_PATH": "/custom/path/to/chrome"
}
}
}
}
See examples/README.md for more configuration options.
# 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
✅ 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
drissionpage-mcp --version
Should output: drissionpage-mcp 0.1.0
# Check browser installation
which google-chrome # Linux
which chromium # macOS
drissionpage-mcp --log-level DEBUGSee TESTING_AND_INTEGRATION.md for complete troubleshooting guide.
| Component | Status |
|---|---|
| Core Features | ✅ Complete |
| Testing | ✅ 100% Coverage |
| Documentation | ✅ Comprehensive |
| Production Ready | ✅ Yes |
| PyPI Package | ✅ Published |
Version: 0.1.0 | License: Apache 2.0 | Maintained: ✅ Active
{
"mcpServers": {
"drissionpage": {
"command": "drissionpage-mcp"
}
}
}
{
"mcpServers": {
"drissionpage": {
"command": "drissionpage-mcp"
}
}
}
See examples/ for more client configurations.
Contributions are welcome!
Best Practices:
Licensed under Apache License 2.0 - see LICENSE
If you find this project useful, please consider:
Made with ❤️ by Wukunyun
Ready to automate your workflows? Install now: pip install drissionpage-mcp
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"drissionpage-mcp-server": {
"command": "npx",
"args": []
}
}
}