MCP Web Browser

🚀 MCP Web Browser Server

The MCP Web Browser Server is a powerful tool that offers a range of features for efficient web page handling, including headless browser support, multi - threading, and a secure sandbox environment.

🚀 Quick Start

Install Dependencies

pip install mcp-web-browser[master]

Initialize Configuration

from mcp_web_browser import BrowserManager

# Create a browser manager instance
browser_manager = BrowserManager()

# Start the default browser instance
browser_manager.start_default_browser()

✨ Features

• Headless Browser Support: Powered by Playwright, it provides robust headless browser capabilities, supporting multiple mainstream browser kernels such as Chromium, Firefox, and WebKit.
• Multi - threading: It has a built - in efficient multi - threading architecture, capable of handling multiple web page requests and tasks simultaneously.
• Extension Plugin Mechanism: It supports a flexible extension plugin system, allowing users to customize functional modules according to their needs.
• Secure Isolation Sandbox: Each browser instance runs in an independent sandbox environment, ensuring that they do not interfere with each other and effectively preventing malicious script attacks.

💻 Usage Examples

Create a New Browser Instance

# Create a new Chromium browser instance
new_browser = browser_manager.create_browser_instance(engine='chromium')

# Visit the specified URL
new_browser.goto('https://www.example.com')

Web Element Operations

# Find and click the login button
login_button = new_browser.find_element(by=By.CSS_SELECTOR, value='#login-btn')
login_button.click()

# Fill in the form information
username_input = new_browser.find_element(by=By.ID, value='username')
password_input = new_browser.find_element(by=By.ID, value='password')
username_input.send_keys('your_username')
password_input.send_keys('your_password')

🔧 Technical Details

Security Features

• Request Filtering: It supports rule - based URL filtering to prevent access to malicious websites.
• Script Sandbox: All user - provided scripts are executed in an isolated environment to ensure the security of the core system.
• Resource Limitation: Each browser instance has an independent resource quota to prevent resource abuse.

Troubleshooting

Problem - Solving Steps

1. Check the browser logs to get detailed error information.
2. Ensure that all dependencies are correctly installed and up - to - date.
3. Check if the system firewall and security software are blocking the necessary ports.

Frequently Asked Questions

• Question: Unable to start a browser instance.
  • Solution: Check if you have sufficient permissions and ensure that the relevant service processes are not killed.

Extension Development

Create a Plugin

1. Create a new Python package.
2. Implement the IBrowserPlugin interface in the package.
3. Register the plugin with the browser manager.

Example Plugin Code

from mcp_web_browser.plugins import IBrowserPlugin

class MyCustomPlugin(IBrowserPlugin):
    def on_before_navigate(self, browser, url):
        print(f"About to visit: {url}")

    def on_after_navigate(self, browser, url):
        print(f"Visited: {url}")

Contribution Guidelines

Set Up the Development Environment

git clone https://github.com/yourusername/mcp-web-browser.git
cd mcp-web-browser
pip install -r requirements.txt

Code Submission Specifications

1. Create an independent development branch for each feature branch.
2. Ensure that all unit tests and integration tests pass before submission.
3. Provide a detailed change log explaining the modified content and reasons.

📄 License

This project is licensed under the MIT License. For more detailed information, please refer to the LICENSE file.

📚 Related Links

• MCP Protocol Official Website
• Playwright Official Website
• Claude Desktop Version

🆘 Support and Help

If you encounter any problems, please seek support in the following ways:

• Submit a GitHub issue: GitHub Issues