Comet Mcp

comet-mcp

为 Claude Code 提供一个会思考的浏览器。

一个将 Claude Code 连接到 Perplexity Comet 的 MCP 服务，可实现 Agent 式网页浏览、深度研究和实时任务监控。

为什么选择它？

Claude Code 现有的网页工具分为两类，但都存在局限：

1. 搜索 API（Tavily、Perplexity API、WebFetch）

返回静态文本。无法交互、登录或处理动态内容。适合快速查询，但无法浏览复杂网站或填写表单。

2. 浏览器自动化（browser-use、Puppeteer MCP、Playwright MCP）

可以与网页交互，但采用一个 Agent 包办一切的方式：编写代码的同一个推理模型，还要决定点击哪里、输入什么以及如何浏览。这会占用过多上下文窗口，分散注意力。

3. Comet MCP：多 Agent 委派

Comet MCP 采用了不同的方法。 Claude 不再直接控制浏览器，而是将任务委派给 Perplexity Comet——一款专为网页研究和浏览打造的 AI。

• Claude 专注于你的编码任务
• Comet 负责浏览：页面导航、登录限制、动态内容和深度研究
• 结果：Claude 的编码智能与 Perplexity 的网页智能协同工作

快速开始

1. 配置 Claude Code

添加到 ~/.claude.json 或 .mcp.json：

{
  "mcpServers": {
    "comet-bridge": {
      "command": "npx",
      "args": ["-y", "comet-mcp"]
    }
  }
}

2. 安装 Comet 浏览器

下载并安装 Perplexity Comet。

就这么简单！MCP 服务会在需要时自动启动 Comet 并开启远程调试。

3. 在 Claude Code 中使用

You: "Use Comet to research the top AI frameworks in 2025"
Claude: [delegates to Comet, monitors progress, returns results]

You: "Log into my GitHub and check my notifications"
Claude: [Comet handles the login flow and navigation]

工具

工具	描述
comet_connect	连接到 Comet（需要时自动启动）
comet_ask	发送任务并等待响应
comet_poll	检查长时间运行任务的进度
comet_stop	停止当前任务
comet_screenshot	截取当前页面
comet_mode	切换模式：搜索、研究、实验室、学习

工作原理

Claude Code  →  MCP Server  →  CDP  →  Comet Browser  →  Perplexity AI
   (reasoning)     (bridge)                              (web browsing)

Claude 发送高层目标（“研究 X”“登录 Y”）。Comet 会处理点击、滚动和搜索，并将结果返回给 Claude。

要求

• Node.js 18+
• Perplexity Comet 浏览器
• Claude Code（或任何 MCP 客户端）
• 支持的平台：macOS、Windows、WSL2

Windows 和 WSL 支持

Windows 原生环境

开箱即用。Comet MCP 会自动检测 Windows，并从默认安装位置启动 Comet。

WSL2（适用于 Linux 的 Windows 子系统）

WSL2 需要启用镜像网络，才能连接在 Windows 上运行的 Comet：

1. 启用镜像网络（一次性设置）：

   # Create/edit %USERPROFILE%\.wslconfig (Windows side)
   [wsl2]
   networkingMode=mirrored
   

2. 重启 WSL：

   wsl --shutdown
   # Then reopen your WSL terminal
   

3. 就这么简单！ Comet MCP 会自动检测 WSL，并使用 PowerShell 与 Windows 通信。

如果无法使用镜像网络，你会看到一条包含设置说明的提示性错误消息。

自定义 Comet 路径

如果 Comet 安装在非标准位置：

{
  "mcpServers": {
    "comet-bridge": {
      "command": "npx",
      "args": ["-y", "comet-mcp"],
      "env": {
        "COMET_PATH": "/path/to/your/Comet"
      }
    }
  }
}

故障排除

“无法连接到 Comet”

• macOS：确保 Comet 安装在 /Applications/Comet.app
• Windows：Comet 应位于 %LOCALAPPDATA%\Perplexity\Comet\Application\
• 检查端口 9222 是否可用

“WSL 无法连接到 Windows localhost”

• 启用镜像网络（参见上方的 WSL 部分）
• 或者改为从 Windows PowerShell 运行 Claude Code

“Claude 中未显示工具”

• 更改配置后重启 Claude Code

许可证

MIT

---

报告问题 · 参与贡献