# ✅ MCPBrowser (MCP Browser)
> ⚠️ **Security Notice:** MCPBrowser extracts webpage content and provides it to your AI agent (e.g., GitHub Copilot, Kiro, Antigravity), which then sends it to the LLM provider it uses (e.g., Anthropic, OpenAI, GitHub) for processing. Make sure you trust both your agent and the LLM provider — especially when accessing pages with sensitive or private data.
**MCP browser server extension for VS Code, Kiro, Antigravity, and compatible editors.** This browser-based MCP server extension enables in-browser web page fetching using your real Chrome, Edge, or Brave browser. Used when loading web pages via browser automation is preferred - handles login, SSO, CAPTCHA, and anti-crawler restrictions. Should be used when standard fetch_webpage fails.
## Features
- 🚀 **One-Click Setup**: Installs npm package and configures mcp.json automatically - complete setup with a single click
- 🔐 **Authentication Support**: Fetches web pages in your Chrome/Edge browser - authenticate once, reuse sessions automatically
- 🤖 **Bypass Anti-Crawler**: Fetch sites that block automated tools, including CAPTCHA and human verification
## Requirements
- Chrome, Edge, or Brave browser
- [Node.js 18+](https://nodejs.org/) (includes npm)
> **Note:** Node.js must be installed on your system. This extension uses Node.js to run the MCP server. VS Code does not include Node.js - download from [nodejs.org](https://nodejs.org/) if not already installed.
## How It Works
When your AI agent needs to fetch a web page via browser:
1. MCPBrowser opens the URL in your Chrome/Edge/Brave browser
2. If authentication is required, you log in normally in the browser
3. MCPBrowser waits for the web page to fully load (handles redirects automatically)
4. Once loaded, it extracts the content and returns it to your AI agent
5. The browser tab stays open to reuse your session for future requests
## Usage
### Installation Steps
1. Install this extension from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=cherchyk.mcpbrowser) or [Open VSX Registry](https://open-vsx.org/extension/cherchyk/mcpbrowser)
2. You'll see a notification: **"MCPBrowser is available! Would you like to configure it?"**
3. Click **"Configure Now"**
4. Wait for "Installing MCPBrowser npm package..." to complete
5. When you see **"MCPBrowser configured successfully!"**, click **"Restart Now"**
6. After restart, MCPBrowser is ready to use with your AI agent!
### Using with Your AI Agent
Once configured, your AI agent (GitHub Copilot, Kiro Agent, Antigravity Agent, etc.) will automatically use MCPBrowser when it encounters auth/crawler blocks. You can also explicitly request it:
**Example prompts:**
```
Fetch https://internal.company.com/docs (I'm already logged in)
Fetch the content from https://portal.azure.com/resources - use my authenticated session
Fetch https://github.com/private-repo/issues using MCPBrowser
```
Your AI agent will use your Chrome/Edge browser session to fetch these pages, bypassing authentication and anti-crawler restrictions.
### Manual Commands
Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`):
- **Configure MCPBrowser** - Set up or update MCP server configuration
- **Remove MCPBrowser** - Remove MCP server configuration
## About MCPBrowser
Alternative web fetcher for AI agents when normal URL fetch fails. Uses Chrome DevTools Protocol to fetch authenticated and crawler-protected web pages through your browser session. Works with GitHub Copilot, Kiro, Antigravity, and any MCP-compatible AI agent.
**Supported editors:** VS Code, Kiro, Antigravity, VSCodium, and any editor supporting Open VSX extensions.
**Use cases:**
1. **Auth-required pages**: 401/403 errors, login pages, SSO, corporate intranets
2. **Anti-bot/crawler blocks**: CAPTCHA, human verification, bot detection
3. **JavaScript-heavy sites**: SPAs, dynamic content requiring browser rendering
Learn more: [MCPBrowser on GitHub](https://github.com/cherchyk/MCPBrowser)
## License
MIT
