Blueprint MCP for Firefox 作者： Rails Blueprint
Give Claude Code and other AI assistants direct control of your real Firefox browser through the Model Context Protocol. Stay logged in, bypass bot detection, automate authenticated workflows.
1 个用户1 个用户
扩展元数据
关于此扩展
Give Claude Code (and other AI assistants) direct control of your real Firefox browser
Stop wrestling with headless browsers, bot detection, and authentication flows. Blueprint MCP for Firefox bridges the Model Context Protocol (MCP) with your actual Firefox browser - keeping you logged into all your sites, preserving your extensions, and using your real browser fingerprint.
THE CRITICAL ADVANTAGE: Efficient browser automation that does not consume your AI's context. Instead of sending massive page snapshots with every action (which quickly exhausts context limits and often exceeds MCP response size limits), Blueprint MCP lets your AI interact directly - click, type, navigate - and only fetch page content when specifically needed. This enables complex, multi-step workflows that would be impossible with snapshot-based approaches.
Perfect for developers using Claude Code, Claude Desktop, Cursor, or any MCP-compatible AI client who need to automate web tasks without the headaches of Playwright/Puppeteer/Selenium.
WHY BLUEPRINT MCP + CLAUDE CODE CHANGES EVERYTHING
The problem: Traditional browser automation requires sending full page snapshots after every action, consuming thousands of tokens per interaction and hitting response size limits. You also lose logged-in sessions, face bot detection, and spend time configuring browser profiles.
The solution: Blueprint MCP connects your AI assistant to your real Firefox browser through direct commands. Your AI controls the browser - click, type, navigate - without needing page snapshots unless explicitly requested. This preserves context for actual decision-making instead of wasting it on redundant page content.
What this enables:
• AI-powered web scraping that bypasses bot detection
• Automated form filling with your saved passwords
• Testing workflows using your logged-in accounts
• Content extraction from authenticated sites
• Browser automation that works with 2FA and CAPTCHAs
KEY FEATURES
Real Browser Automation:
• Uses your actual Firefox profile - Stays logged into Gmail, GitHub, AWS, etc.
• Stealth mode - No bot detection. Uses your real browser fingerprint
• Extension support - Works alongside your existing Firefox extensions
• Session persistence - No re-authentication needed
Native MCP Integration:
• 20+ browser tools exposed via Model Context Protocol
• Tab management - Create, switch, close tabs programmatically
• Content extraction - Get page content as clean Markdown
• Network monitoring - Capture requests, replay with authentication
• JavaScript execution - Run code in page context
Developer Experience:
• Zero setup - Install extension, works instantly
• Auto-reconnection - Survives browser restarts
• Debug mode - Verbose logging for troubleshooting
• Status visibility - Real-time connection status
Two Connection Modes:
• Free (Local) - WebSocket on localhost:5555, no cloud dependencies
• PRO (Cloud Relay) - Control browser from anywhere, multiple AI clients
Comprehensive Automation:
• Screenshots (viewport or elements)
• Content extraction as Markdown
• Form automation (fill, dropdowns, file uploads)
• Mouse/keyboard control (click, type, hover, scroll)
• Tech stack detection (40+ frameworks)
Advanced Capabilities:
• Network request monitoring with filters
• Network request replay
• Extension management
• Element visibility verification
• JavaScript execution
HOW IT WORKS
Architecture:
AI Assistant (Claude Code) -> MCP Protocol -> MCP Server -> JSON-RPC over WebSocket -> Firefox Extension (this) -> Firefox WebExtensions APIs -> Your Firefox Browser
Setup (3 steps, 2 minutes):
1. Install MCP server: npm install -g @railsblueprint/blueprint-mcp
2. Install this Firefox extension
3. Configure AI client: claude mcp add browser npx @railsblueprint/blueprint-mcp@latest
The extension auto-connects when your AI client starts the MCP server.
USE CASES
TECHNICAL DETAILS
Available MCP Tools (20+):
Connection: enable, disable, status, auth, browser_connect
Tabs: browser_tabs (list/new/attach/close)
Navigation: browser_navigate (url/back/forward/reload)
Content: browser_take_screenshot, browser_extract_content, browser_console_messages, browser_network_requests
Interaction: browser_interact (click/type/hover/scroll), browser_fill_form, browser_lookup, browser_drag
Advanced: browser_evaluate, browser_verify_text_visible, browser_verify_element_visible
Extensions: browser_list_extensions, browser_reload_extensions
API Capabilities:
• CSS selectors + :has-text() pseudo-selector
• Network monitoring with filters (URL, method, status, type)
• JSONPath filtering for large JSON responses
• JavaScript execution with async/await support
Firefox-Specific Limitations:
• browser_snapshot not available (Firefox doesn't support Accessibility.getFullAXTree CDP method)
• browser_handle_dialog not available (Firefox doesn't support Page.handleJavaScriptDialog CDP method)
• browser_pdf_save not available (Firefox doesn't support Page.printToPDF CDP method)
• browser_performance_metrics not available (Firefox doesn't support Target.getTargetInfo CDP method)
• browser_window resize/maximize not available (Firefox doesn't support Emulation.setDeviceMetricsOverride CDP method)
• Forced pseudo-states (:hover, :focus) not available (Firefox doesn't support DOM.enable CDP method)
For these features, Chrome/Edge (Chromium) is recommended. See compatibility documentation for workarounds.
General Limitations:
• Cannot automate about: pages (Firefox restriction)
• Free tier: Local connection only (same machine)
• Screenshot size limit: 10MB
• Network history limit: 1000 requests
Requirements:
• Firefox 128+ (for Manifest V3 support)
• Node.js 18+ (for MCP server)
• MCP-compatible AI client
• Port 5555 available (Free tier)
SECURITY & PRIVACY
Free Tier (Local Mode):
• All communication stays on your machine (localhost WebSocket)
• Zero data sent to cloud
• No tracking, telemetry, or analytics
• Works completely offline
• No account required
PRO Tier (Cloud Relay):
• Commands and responses pass through relay (including page content/screenshots when requested)
• OAuth2 tokens stored locally (encrypted by Firefox)
• No logging - data passes through relay but is not stored or logged anywhere
• Your browsing activity is not tracked or monitored
Permissions Explained:
tabs - Tab management (list, create, switch, close)
activeTab - Current tab access for content reading
storage - Local preferences and OAuth tokens (PRO)
webRequest - Network monitoring for capture/replay
webNavigation - Detect page loads, clear stale state
scripting - Content script injection for tech detection
management - Extension listing/reloading
<all_urls> - Required for automation on any site (your data NEVER leaves your machine in Free tier)
What We DON'T Collect:
Browsing history, page content, cookies, form inputs, passwords, personal info, analytics
Open Source:
• Full source: https://github.com/railsblueprint/blueprint-mcp
• Apache 2.0 license
• Audit the code yourself
PRICING
Free Tier - $0/month
• All 20+ browser automation tools
• Local WebSocket connection
• Unlimited usage
• Zero cloud dependencies
• Same machine only
PRO Tier - $5/month or $50/year ($1 for 14-day trial)
Everything in Free, plus:
• Cloud Relay (control from anywhere)
• Multiple browsers
• Multi-client access
• Auto-reconnection
• Priority support
Upgrade: https://blueprint-mcp.railsblueprint.com/pro
Enterprise - Custom pricing
Self-hosted relay, custom integrations, SLA guarantees. Contact: support@railsblueprint.com
SUPPORT
Documentation: https://github.com/railsblueprint/blueprint-mcp
Firefox Compatibility: https://github.com/railsblueprint/blueprint-mcp/blob/main/docs/FIREFOX_COMPATIBILITY.md
GitHub Issues: https://github.com/railsblueprint/blueprint-mcp/issues
Email: support@railsblueprint.com
Troubleshooting:
Not connecting?
1. Check MCP server running: npx @railsblueprint/blueprint-mcp@latest --debug
2. Verify port 5555 available
3. Check extension popup shows "Connected"
4. Review debug logs in Browser Console
AI can't find tools?
1. Verify MCP server in AI client config
2. Restart AI client after config change
3. Run enable tool first to activate
Need help? Open GitHub issue with Firefox/extension version, MCP server version, AI client used, and debug logs.
Blueprint MCP for Firefox - Give your AI assistant the browser automation it deserves.
https://mcp-for-firefox.railsblueprint.com
https://github.com/railsblueprint/blueprint-mcp
Stop wrestling with headless browsers, bot detection, and authentication flows. Blueprint MCP for Firefox bridges the Model Context Protocol (MCP) with your actual Firefox browser - keeping you logged into all your sites, preserving your extensions, and using your real browser fingerprint.
THE CRITICAL ADVANTAGE: Efficient browser automation that does not consume your AI's context. Instead of sending massive page snapshots with every action (which quickly exhausts context limits and often exceeds MCP response size limits), Blueprint MCP lets your AI interact directly - click, type, navigate - and only fetch page content when specifically needed. This enables complex, multi-step workflows that would be impossible with snapshot-based approaches.
Perfect for developers using Claude Code, Claude Desktop, Cursor, or any MCP-compatible AI client who need to automate web tasks without the headaches of Playwright/Puppeteer/Selenium.
WHY BLUEPRINT MCP + CLAUDE CODE CHANGES EVERYTHING
The problem: Traditional browser automation requires sending full page snapshots after every action, consuming thousands of tokens per interaction and hitting response size limits. You also lose logged-in sessions, face bot detection, and spend time configuring browser profiles.
The solution: Blueprint MCP connects your AI assistant to your real Firefox browser through direct commands. Your AI controls the browser - click, type, navigate - without needing page snapshots unless explicitly requested. This preserves context for actual decision-making instead of wasting it on redundant page content.
What this enables:
• AI-powered web scraping that bypasses bot detection
• Automated form filling with your saved passwords
• Testing workflows using your logged-in accounts
• Content extraction from authenticated sites
• Browser automation that works with 2FA and CAPTCHAs
KEY FEATURES
Real Browser Automation:
• Uses your actual Firefox profile - Stays logged into Gmail, GitHub, AWS, etc.
• Stealth mode - No bot detection. Uses your real browser fingerprint
• Extension support - Works alongside your existing Firefox extensions
• Session persistence - No re-authentication needed
Native MCP Integration:
• 20+ browser tools exposed via Model Context Protocol
• Tab management - Create, switch, close tabs programmatically
• Content extraction - Get page content as clean Markdown
• Network monitoring - Capture requests, replay with authentication
• JavaScript execution - Run code in page context
Developer Experience:
• Zero setup - Install extension, works instantly
• Auto-reconnection - Survives browser restarts
• Debug mode - Verbose logging for troubleshooting
• Status visibility - Real-time connection status
Two Connection Modes:
• Free (Local) - WebSocket on localhost:5555, no cloud dependencies
• PRO (Cloud Relay) - Control browser from anywhere, multiple AI clients
Comprehensive Automation:
• Screenshots (viewport or elements)
• Content extraction as Markdown
• Form automation (fill, dropdowns, file uploads)
• Mouse/keyboard control (click, type, hover, scroll)
• Tech stack detection (40+ frameworks)
Advanced Capabilities:
• Network request monitoring with filters
• Network request replay
• Extension management
• Element visibility verification
• JavaScript execution
HOW IT WORKS
Architecture:
AI Assistant (Claude Code) -> MCP Protocol -> MCP Server -> JSON-RPC over WebSocket -> Firefox Extension (this) -> Firefox WebExtensions APIs -> Your Firefox Browser
Setup (3 steps, 2 minutes):
1. Install MCP server: npm install -g @railsblueprint/blueprint-mcp
2. Install this Firefox extension
3. Configure AI client: claude mcp add browser npx @railsblueprint/blueprint-mcp@latest
The extension auto-connects when your AI client starts the MCP server.
USE CASES
- Authenticated Web Scraping
Before: Manually log in, navigate, copy-paste data. Bot detection, session timeouts.
With Blueprint MCP: "Go to dashboard.company.com and extract the Q4 metrics table" - Uses your logged-in session automatically. - Multi-Step Form Automation
Before: 2 hours/week manually filling vendor forms across 5 portals.
With Blueprint MCP: "Fill out the vendor forms with my company info" - 2 hours -> 5 minutes. - Testing Logged-In Workflows
Before: Create test accounts, configure webhooks, manual testing.
With Blueprint MCP: "Test the upgrade flow from free to pro" - Tests with real authentication. - Documentation Screenshots
Before: 3+ hours manually capturing and editing screenshots.
With Blueprint MCP: "Generate screenshots for all onboarding steps" - Consistent screenshots in minutes. - API Testing via Browser
Before: Copy cookies manually, troubleshoot auth, replay requests.
With Blueprint MCP: "Capture API calls when I click Submit and replay them" - Debug with actual browser authentication.
TECHNICAL DETAILS
Available MCP Tools (20+):
Connection: enable, disable, status, auth, browser_connect
Tabs: browser_tabs (list/new/attach/close)
Navigation: browser_navigate (url/back/forward/reload)
Content: browser_take_screenshot, browser_extract_content, browser_console_messages, browser_network_requests
Interaction: browser_interact (click/type/hover/scroll), browser_fill_form, browser_lookup, browser_drag
Advanced: browser_evaluate, browser_verify_text_visible, browser_verify_element_visible
Extensions: browser_list_extensions, browser_reload_extensions
API Capabilities:
• CSS selectors + :has-text() pseudo-selector
• Network monitoring with filters (URL, method, status, type)
• JSONPath filtering for large JSON responses
• JavaScript execution with async/await support
Firefox-Specific Limitations:
• browser_snapshot not available (Firefox doesn't support Accessibility.getFullAXTree CDP method)
• browser_handle_dialog not available (Firefox doesn't support Page.handleJavaScriptDialog CDP method)
• browser_pdf_save not available (Firefox doesn't support Page.printToPDF CDP method)
• browser_performance_metrics not available (Firefox doesn't support Target.getTargetInfo CDP method)
• browser_window resize/maximize not available (Firefox doesn't support Emulation.setDeviceMetricsOverride CDP method)
• Forced pseudo-states (:hover, :focus) not available (Firefox doesn't support DOM.enable CDP method)
For these features, Chrome/Edge (Chromium) is recommended. See compatibility documentation for workarounds.
General Limitations:
• Cannot automate about: pages (Firefox restriction)
• Free tier: Local connection only (same machine)
• Screenshot size limit: 10MB
• Network history limit: 1000 requests
Requirements:
• Firefox 128+ (for Manifest V3 support)
• Node.js 18+ (for MCP server)
• MCP-compatible AI client
• Port 5555 available (Free tier)
SECURITY & PRIVACY
Free Tier (Local Mode):
• All communication stays on your machine (localhost WebSocket)
• Zero data sent to cloud
• No tracking, telemetry, or analytics
• Works completely offline
• No account required
PRO Tier (Cloud Relay):
• Commands and responses pass through relay (including page content/screenshots when requested)
• OAuth2 tokens stored locally (encrypted by Firefox)
• No logging - data passes through relay but is not stored or logged anywhere
• Your browsing activity is not tracked or monitored
Permissions Explained:
tabs - Tab management (list, create, switch, close)
activeTab - Current tab access for content reading
storage - Local preferences and OAuth tokens (PRO)
webRequest - Network monitoring for capture/replay
webNavigation - Detect page loads, clear stale state
scripting - Content script injection for tech detection
management - Extension listing/reloading
<all_urls> - Required for automation on any site (your data NEVER leaves your machine in Free tier)
What We DON'T Collect:
Browsing history, page content, cookies, form inputs, passwords, personal info, analytics
Open Source:
• Full source: https://github.com/railsblueprint/blueprint-mcp
• Apache 2.0 license
• Audit the code yourself
PRICING
Free Tier - $0/month
• All 20+ browser automation tools
• Local WebSocket connection
• Unlimited usage
• Zero cloud dependencies
• Same machine only
PRO Tier - $5/month or $50/year ($1 for 14-day trial)
Everything in Free, plus:
• Cloud Relay (control from anywhere)
• Multiple browsers
• Multi-client access
• Auto-reconnection
• Priority support
Upgrade: https://blueprint-mcp.railsblueprint.com/pro
Enterprise - Custom pricing
Self-hosted relay, custom integrations, SLA guarantees. Contact: support@railsblueprint.com
SUPPORT
Documentation: https://github.com/railsblueprint/blueprint-mcp
Firefox Compatibility: https://github.com/railsblueprint/blueprint-mcp/blob/main/docs/FIREFOX_COMPATIBILITY.md
GitHub Issues: https://github.com/railsblueprint/blueprint-mcp/issues
Email: support@railsblueprint.com
Troubleshooting:
Not connecting?
1. Check MCP server running: npx @railsblueprint/blueprint-mcp@latest --debug
2. Verify port 5555 available
3. Check extension popup shows "Connected"
4. Review debug logs in Browser Console
AI can't find tools?
1. Verify MCP server in AI client config
2. Restart AI client after config change
3. Run enable tool first to activate
Need help? Open GitHub issue with Firefox/extension version, MCP server version, AI client used, and debug logs.
Blueprint MCP for Firefox - Give your AI assistant the browser automation it deserves.
https://mcp-for-firefox.railsblueprint.com
https://github.com/railsblueprint/blueprint-mcp
评分 0（1 位用户）
权限与数据
更多信息