comet-mcp 是一个 MCP（Model Context Protocol）服务器，用于将 Claude Code 连接到 Perplexity Comet 浏览器，从而实现智能体式网页浏览、深度研究和实时任务监控。它的核心理念是“给 Claude Code 一个会思考的浏览器”。
用途与背景
现有的 Claude Code 网页工具主要分为两类，各有局限：
- 搜索 API（如 Tavily、Perplexity API、WebFetch）：返回静态文本，无法交互、登录或处理动态内容，适合快速查询，但难以导航复杂网站或填写表单。
- 浏览器自动化工具（如 browser-use、Puppeteer MCP、Playwright MCP）：可以交互，但采用单一智能体处理所有事务的方式，即写代码的推理模型同时决定点击、输入和导航位置，这会占用大量上下文窗口并分散注意力。
Comet MCP 采用多智能体委托方案：Claude 不直接控制浏览器，而是将浏览任务委托给专为网页研究和浏览设计的 Perplexity Comet。Claude 保持对编码任务的专注，Comet 处理导航、登录墙、动态内容和深度研究。结果是 Claude 的编码智能与 Perplexity 的网页智能协同工作。
主要能力
- 委托网页浏览：Claude 发送高层目标（如“研究 X”“登录 Y”），Comet 负责实际的点击、滚动和搜索，结果返回给 Claude。
- 深度研究：利用 Perplexity Comet 的网页研究能力完成复杂信息搜集。
- 实时任务监控：支持对任务执行过程进行监控。
- 跨平台支持：macOS、Windows、WSL2。
使用方式
- 配置 Claude Code：在 ~/.claude.json 或 .mcp.json 中添加相关配置（具体配置内容官方文档未提供）。
- 安装 Comet 浏览器：下载并安装 Perplexity Comet。
- 在 Claude Code 中使用：MCP 服务器会在需要时自动启动带有远程调试功能的 Comet。
Windows 与 WSL 支持
- Windows：开箱即用。Comet MCP 自动检测 Windows 并从默认安装位置启动 Comet。
- WSL2：需要镜像网络模式才能连接到 Windows 上运行的 Comet。
- 一次性设置：创建或编辑 %USERPROFILE%.wslconfig（Windows 端），添加 [wsl2] networkingMode=mirrored
- 重启 WSL：运行 wsl --shutdown，然后重新打开 WSL 终端。
- Comet MCP 会自动检测 WSL 并使用 PowerShell 与 Windows 通信。如果镜像网络不可用，会显示带有设置说明的错误消息。
自定义 Comet 路径
如果 Comet 安装在非标准位置，可进行自定义路径配置（具体配置方式官方文档未提供）。
故障排除
- “Cannot connect to Comet”：macOS 确保 Comet 安装在 /Applications/Comet.app；Windows 应位于 %LOCALAPPDATA%\Perplexity\Comet\Application\；检查端口 9222 是否可用。
- “WSL cannot connect to Windows localhost”：启用镜像网络，或从 Windows PowerShell 而非 WSL 运行 Claude Code。
- “Tools not showing in Claude”：更改配置后重启 Claude Code。
适用场景
- 需要在编码过程中进行复杂网页研究、登录或处理动态内容的开发者。
- 希望将网页浏览任务从编码智能体中分离出来，避免上下文窗口过载的用户。
- 使用 Claude Code 并希望增强其网页交互能力的团队。
限制
- 依赖 Perplexity Comet 浏览器和 Claude Code（或任何 MCP 客户端）。
- WSL2 需要镜像网络模式，可能受系统限制。
- 具体配置细节、安装命令和代码内容官方文档未完整提供，需参考仓库进一步了解。
