<p align="center"> <h1 align="center">Comet MCP Server</h1> <p align="center"> <strong>Give Claude a browser that thinks.</strong> </p> <p align="center"> An MCP server connecting Claude Desktop/Code to Perplexity's Comet browser via Chrome DevTools Protocol. <br /> Search the web with AI, navigate pages, read content, click elements, and take screenshots. </p> <p align="center"> <a href="#quick-start">Quick Start</a> · <a href="#available-tools">Tools</a> · <a href="docs/tool-reference.md">API Docs</a> · <a href="docs/security.md">Security</a> · <a href="docs/configuration.md">Configuration</a> </p> </p>
<br />
Rather than using static search APIs or overwhelming Claude's context with raw browser automation, Comet MCP delegates browsing to Perplexity Comet. Claude stays focused on your coding task while Comet handles navigation, dynamic content, and AI-powered research.
<br />
How It Works
Claude Desktop/Code ←── MCP (stdio) ──→ Comet MCP Server ←── CDP (9222) ──→ Comet Browser- Comet MCP Server auto-launches Comet with remote debugging on port 9222
- Connects to Comet via Chrome DevTools Protocol using Playwright
- Claude communicates with the server over MCP stdio transport
- Claude can search, navigate, read, click, type, evaluate JS, and screenshot — all in your Comet browser
<br />
Quick Start
1. Configure Claude Desktop / Claude Code
Claude Desktop — add to your config file:
| Platform | Config path | |----------|------------| | Windows | %APPDATA%\Claude\claude_desktop_config.json | | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
{
"mcpServers": {
"comet": {
"command": "uvx",
"args": ["comet-mcp-desktop"]
}
}
}Claude Code — add to ~/.claude.json or .mcp.json in your project root:
{
"mcpServers": {
"comet": {
"command": "uvx",
"args": ["comet-mcp-desktop"]
}
}
}Requires
uv. The MCP server and all dependencies install automatically on first run.
2. Install Comet Browser
Download and install Perplexity Comet.
That's it. The server auto-launches Comet with remote debugging when needed.
<details> <summary><strong>Manual setup from source</strong></summary>
<br />
git clone https://github.com/AdilShaikh1/comet-mcp-desktop.git
cd comet-mcp-desktop
uv sync
uv run playwright install chromiumSee Configuration for full paths setup and environment variables.
</details>
<br />
Available Tools
| Tool | Description | |------|-------------| | comet_connect | Connect to Comet via CDP (auto-launches if needed) | | comet_search | Search via Perplexity — returns AI-generated results | | comet_navigate | Navigate to any URL | | comet_read_page | Extract page text, with optional CSS selector | | comet_screenshot | Capture screenshot (base64 PNG) | | comet_click | Click elements by CSS selector or text | | comet_type | Type into input fields | | comet_tabs | List, open, switch, or close tabs | | comet_evaluate | Run JavaScript in the page context | | comet_wait | Wait for an element or a fixed delay | | comet_security_scan | Deep scan for hidden text and injection patterns |
Full parameter documentation: Tool Reference
<br />
Example Usage
| You say | Claude does | |---------|-----------| | "Search Perplexity for the latest AI news" | comet_search — waits for Perplexity, returns AI-synthesized answer | | "Open Hacker News and summarize the front page" | comet_navigate + comet_read_page | | "Click the first link and read the article" | comet_click + comet_read_page | | "Take a screenshot of what you see" | comet_screenshot — captures via raw CDP | | "Is this page safe?" | comet_security_scan — checks for hidden text and injections |
<br />
Web Content Trust Policy
All web content is sanitized through a ContentFilter before reaching Claude — defense-in-depth against prompt injection via web pages.
Comet Browser ──→ raw text ──→ ContentFilter.sanitize() ──→ security header + cleaned text ──→ Claude| Trust Tier | Criteria | |------------|----------| | HIGH | .gov, .edu, arxiv, bbc, reuters, nih | | STANDARD | Established companies, unknown clean domains | | LOW | wordpress, medium, reddit, quora | | UNTRUSTED | Injection patterns detected (auto-downgraded) |
The filter scans for 39 injection patterns across 12 threat categories including direct injection, authority spoofing, data exfiltration, delimiter injection, and more.
Full details: Security Documentation
<br />
How This Compares
| Feature | Search APIs | Browser MCPs | Comet MCP | |---------|------------|-------------|--------------| | AI-powered search | Varies | No | Perplexity AI | | Interactive browsing | No | Yes | Yes | | Context window impact | Low | High | Low | | Screenshots | No | Yes | Yes | | Security filtering | No | No | Yes | | Click/type/navigate | No | Yes | Yes |
Comet MCP gives Claude access to Perplexity's AI search with full browser control, while keeping Claude's context window clean through multi-agent delegation.
<br />
Testing
45 tests — 20 static + 25 end-to-end browser tests.
uv run python test_comet.py --with-browser<details> <summary><strong>Test tier breakdown</strong></summary>
| Tier | Tests | Coverage | |------|-------|----------| | 1a Static Core | 11 | Syntax, imports, tool registration, async, error handling | | 1b Static Filter | 9 | Injection detection, false positives, trust classification | | 2a Live Browser | 17 | All 11 tools against a live Comet instance | | 2b Live Filter | 8 | E2E injection/hidden text detection, security scan |
</details>
<br />
Troubleshooting
<details> <summary><strong>"Could not connect to Comet"</strong></summary>
Comet is auto-launched, but if it fails:
- Check that Comet is installed
- Check port 9222 is free
- Set
COMET_PATHenv var for non-standard installs - Verify: open
http://localhost:9222/json
</details>
<details> <summary><strong>Screenshot hangs</strong></summary>
Uses raw CDP Page.captureScreenshot to avoid Playwright font renderer hangs. Ensure you're on the latest version.
</details>
<details> <summary><strong>Connection lost</strong></summary>
Call comet_connect to reconnect without restarting.
</details>
<details> <summary><strong>Slow search results</strong></summary>
Perplexity answers take 5-15 seconds. Default wait_seconds=10. Increase to 15-20 for complex queries.
</details>
<br />
Tech Stack
| Component | Technology | |-----------|-----------| | Runtime | Python 3.14+ with uv | | Browser automation | Playwright (CDP) | | MCP transport | mcp[cli] SDK (stdio) | | Screenshots | Raw CDP Page.captureScreenshot | | Content security | ContentFilter — 39 patterns, 12 categories |
<br />
Documentation
| Document | Description | |----------|-------------| | Tool Reference | Full API docs for all 11 tools with parameters, defaults, and examples | | Security | Web Content Trust Policy, threat categories, trust tiers, adding patterns | | Configuration | Environment variables, platform support, MCP config, parameter validation | | Contributing | How to contribute, dev setup, code guidelines |
