{"id":39534918,"url":"https://github.com/hanzili/comet-mcp","last_synced_at":"2026-01-18T06:32:25.408Z","repository":{"id":332274843,"uuid":"1127060665","full_name":"hanzili/comet-mcp","owner":"hanzili","description":"MCP Server connecting to Perplexity Comet browser","archived":false,"fork":false,"pushed_at":"2026-01-13T05:34:37.000Z","size":41834,"stargazers_count":96,"open_issues_count":0,"forks_count":6,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T08:40:19.967Z","etag":null,"topics":["agentic-ai","agentic-browser","automation","mcp-server"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hanzili.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-03T05:05:45.000Z","updated_at":"2026-01-13T05:34:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hanzili/comet-mcp","commit_stats":null,"previous_names":["hanzili/comet-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/hanzili/comet-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hanzili%2Fcomet-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hanzili%2Fcomet-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hanzili%2Fcomet-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hanzili%2Fcomet-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hanzili","download_url":"https://codeload.github.com/hanzili/comet-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hanzili%2Fcomet-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28531997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","agentic-browser","automation","mcp-server"],"created_at":"2026-01-18T06:32:25.353Z","updated_at":"2026-01-18T06:32:25.401Z","avatar_url":"https://github.com/hanzili.png","language":"TypeScript","funding_links":[],"categories":["カテゴリ","📦 Other"],"sub_categories":["🛠️ \u003ca name=\"developer-tools\"\u003e\u003c/a\u003e開発ツール"],"readme":"# comet-mcp\n\n[![npm version](https://img.shields.io/npm/v/comet-mcp.svg)](https://www.npmjs.com/package/comet-mcp)\n\n\u003ca href=\"https://glama.ai/mcp/servers/@hanzili/comet-mcp\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@hanzili/comet-mcp/badge\" /\u003e\n\u003c/a\u003e\n\n**Give Claude Code a browser that thinks.**\n\nAn MCP server that connects Claude Code to [Perplexity Comet](https://www.perplexity.ai/comet) - enabling agentic web browsing, deep research, and real-time task monitoring.\n\n![Demo](demo.gif)\n\n## Why?\n\nExisting web tools for Claude Code fall into two categories, both with limitations:\n\n### 1. Search APIs (Tavily, Perplexity API, WebFetch)\nReturn static text. No interaction, no login, no dynamic content. Great for quick lookups, but can't navigate complex sites or fill forms.\n\n### 2. Browser Automation (browser-use, Puppeteer MCP, Playwright MCP)\nCan interact with pages, but use a **one-agent-do-all** approach: the same reasoning model that's writing your code is also deciding where to click, what to type, and how to navigate. This overwhelms the context window and fragments focus.\n\n### 3. Comet MCP: Multi-Agent Delegation\n**Comet MCP takes a different approach.** Instead of Claude controlling a browser directly, it delegates to [Perplexity Comet](https://www.perplexity.ai/comet) - an AI purpose-built for web research and browsing.\n\n- **Claude** stays focused on your coding task\n- **Comet** handles the browsing: navigation, login walls, dynamic content, deep research\n- **Result**: Claude's coding intelligence + Perplexity's web intelligence, working together\n\n## Quick Start\n\n### 1. Configure Claude Code\n\nAdd to `~/.claude.json` or `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"comet-bridge\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"comet-mcp\"]\n    }\n  }\n}\n```\n\n### 2. Install Comet Browser\n\nDownload and install [Perplexity Comet](https://www.perplexity.ai/comet).\n\nThat's it! The MCP server automatically launches Comet with remote debugging when needed.\n\n### 3. Use in Claude Code\n\n```\nYou: \"Use Comet to research the top AI frameworks in 2025\"\nClaude: [delegates to Comet, monitors progress, returns results]\n\nYou: \"Log into my GitHub and check my notifications\"\nClaude: [Comet handles the login flow and navigation]\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `comet_connect` | Connect to Comet (auto-starts if needed) |\n| `comet_ask` | Send a task and wait for response |\n| `comet_poll` | Check progress on long-running tasks |\n| `comet_stop` | Stop current task |\n| `comet_screenshot` | Capture current page |\n| `comet_mode` | Switch modes: search, research, labs, learn |\n\n## How It Works\n\n```\nClaude Code  →  MCP Server  →  CDP  →  Comet Browser  →  Perplexity AI\n   (reasoning)     (bridge)                              (web browsing)\n```\n\nClaude sends high-level goals (\"research X\", \"log into Y\"). Comet figures out the clicks, scrolls, and searches. Results flow back to Claude.\n\n## Requirements\n\n- Node.js 18+\n- [Perplexity Comet Browser](https://www.perplexity.ai/comet)\n- Claude Code (or any MCP client)\n- **Supported platforms**: macOS, Windows, WSL2\n\n## Windows \u0026 WSL Support\n\n### Native Windows\nWorks out of the box. Comet MCP auto-detects Windows and launches Comet from its default install location.\n\n### WSL2 (Windows Subsystem for Linux)\nWSL2 requires **mirrored networking** to connect to Comet running on Windows:\n\n1. **Enable mirrored networking** (one-time setup):\n   ```\n   # Create/edit %USERPROFILE%\\.wslconfig (Windows side)\n   [wsl2]\n   networkingMode=mirrored\n   ```\n\n2. **Restart WSL**:\n   ```bash\n   wsl --shutdown\n   # Then reopen your WSL terminal\n   ```\n\n3. **That's it!** Comet MCP auto-detects WSL and uses PowerShell to communicate with Windows.\n\nIf mirrored networking isn't available, you'll see a helpful error message with setup instructions.\n\n### Custom Comet Path\nIf Comet is installed in a non-standard location:\n```json\n{\n  \"mcpServers\": {\n    \"comet-bridge\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"comet-mcp\"],\n      \"env\": {\n        \"COMET_PATH\": \"/path/to/your/Comet\"\n      }\n    }\n  }\n}\n```\n\n## Troubleshooting\n\n**\"Cannot connect to Comet\"**\n- **macOS**: Ensure Comet is installed at `/Applications/Comet.app`\n- **Windows**: Comet should be in `%LOCALAPPDATA%\\Perplexity\\Comet\\Application\\`\n- Check if port 9222 is available\n\n**\"WSL cannot connect to Windows localhost\"**\n- Enable mirrored networking (see WSL section above)\n- Or run Claude Code from Windows PowerShell instead of WSL\n\n**\"Tools not showing in Claude\"**\n- Restart Claude Code after config changes\n\n## License\n\nMIT\n\n---\n\n[Report Issues](https://github.com/hanzili/comet-mcp/issues) · [Contribute](https://github.com/hanzili/comet-mcp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhanzili%2Fcomet-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhanzili%2Fcomet-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhanzili%2Fcomet-mcp/lists"}