FoxProxy

# Firefox Control Tools A collection of automation tools for Firefox designed specifically for use with Claude_Desktop & MCP Desktop Commander. ## Overview Firefox Control Tools was entirely conceived, designed, and implemented through interactions with Claude_Desktop & MCP Desktop Commander. This system represents a practical implementation of Claude-powered automation, enabling seamless browser control with minimal user intervention. The tools provide multiple approaches to Firefox automation, all designed to be used within the Claude_Desktop & MCP Desktop Commander environment: 1. **FoxProxy (Command-line)**: Lightweight command-line interface developed with guidance from Claude for controlling Firefox using native command-line arguments 2. **Selenium-based Scripts**: More powerful automation using Selenium WebDriver for complex interactions, with code written through Claude collaboration 3. **Workflow System**: JSON-based workflow configurations created via Claude for common automation tasks ## Claude_Desktop & MCP Desktop Commander Integration These tools were specifically engineered to work within the Claude_Desktop & MCP Desktop Commander environment: - **Direct Command Execution**: All commands can be issued directly through the Claude interface - **Script Generation**: Claude can dynamically generate custom PowerShell scripts based on your needs - **Workflow Creation**: Claude can design and modify workflow JSON files to automate complex tasks - **Problem Solving**: Claude can troubleshoot and optimize Firefox automation in real-time - **Seamless Execution**: Execute commands without leaving the Claude interface ## Repository Structure - `cli/` - Command-line interface tools - FoxProxy for simple Firefox control via command line - Created through Claude's PowerShell expertise - `selenium/` - Selenium WebDriver-based scripts - More powerful automation capabilities written by Claude - Designed for execution within the MCP Desktop Commander environment - `workflows/` - Workflow configuration files - JSON workflow definitions created through Claude collaboration - Optimized for Claude-guided execution - `archive/` - Historical versions and legacy scripts - Previous iterations from the Claude collaboration process - Development history showing Claude's reasoning and improvements ## Features ### FoxProxy (CLI) - Open URLs in new windows or tabs directly from Claude_Desktop - Launch private browsing sessions through Claude commands - Perform searches using Claude-generated queries - Get information about running Firefox instances for Claude to analyze - Control existing Firefox instances through Claude's interface - Restart or quit Firefox with simple Claude commands ### Selenium Scripts - Automate form filling and login processes with Claude-generated credentials - Interact with page elements through Claude's guidance - Execute JavaScript within the page authored by Claude - Take screenshots for Claude to analyze - Complex automation flows orchestrated by Claude ## Quick Start ### Using with Claude_Desktop & MCP Desktop Commander 1. Simply ask Claude to help you control Firefox 2. Claude can execute commands directly or guide you through the process 3. Example prompts: - "Open example.com in Firefox" - "Create a workflow to automate logging into my email" - "Help me take a screenshot of a webpage" - "Generate a script to fill out a form automatically" ### FoxProxy (Command-Line Interface) 1. Ask Claude to execute commands with the `fox.cmd` wrapper: ``` # Get information about running Firefox instances fox.cmd -Action info # Open a URL in a new tab fox.cmd -Action open -Url "https://example.com" -Tab "tab" # Perform a Google search fox.cmd -Action search -Query "firefox automation" # Open a private browsing window fox.cmd -Action private -Url "https://example.com" ``` ### Selenium-based Automation 1. Have Claude install the required Selenium module: ```powershell Install-Module -Name Selenium -Force ``` 2. Ask Claude to run or modify a script from the `selenium` directory: ```powershell .\send_facebook_message.ps1 -Recipient "username" -Message "Hello!" ``` ## Requirements - Windows operating system - Claude_Desktop & MCP Desktop Commander - PowerShell 5.1 or higher - Firefox browser installed in default location - Selenium PowerShell module (for Selenium-based scripts only) ## Development Process This entire project was conceived, designed, coded, and tested through interactions with Claude_Desktop & MCP Desktop Commander. The development process involved: 1. Initial concept discussions with Claude 2. Claude-generated code for core functionality 3. Iterative improvements based on Claude's suggestions 4. Problem-solving and debugging with Claude's assistance 5. Documentation and example creation guided by Claude ## License This project is licensed under the MIT License - see the LICENSE file for details.