浏览器 MCP 服务器,拥有真实的身份
把 Clearcote 加入你的 MCP 客户端配置,模型就有了一个浏览器,可以通过 20 个工具在其中阅读、点击和输入。身份只需在环境变量中设置一次,所以工具列表保持精简,智能体工作期间指纹也始终一致。
无需密钥即可运行开源版构建。加上免费的 GitHub 密钥,就能用上最新构建。
加入你的客户端配置
{
"mcpServers": {
"clearcote": {
"command": "npx",
"args": ["-y", "clearcote-mcp"],
"env": {
"CLEARCOTE_FINGERPRINT": "acct-1",
"CLEARCOTE_TIMEZONE": "America/New_York",
"CLEARCOTE_ACCEPT_LANGUAGE": "en-US"
}
}
}
}亮点
20 个工具
navigate、read_page、page_elements、click、fill_field 和 screenshot_page,另有等待、按键、标签页、cookie、PDF 和已保存会话等工具。
身份不写在提示词里
种子、平台、品牌、语言和时区都通过 CLEARCOTE_* 环境变量设置。模型完全不必去琢磨指纹。
你已经在用的客户端
Claude Desktop、Cursor 和 Cline 的配置格式相同。从 PyPI 安装,然后直接运行,或通过 npx 启动器运行。
没有自动化开关
服务器启动浏览器时不带 Playwright 的自动化开关,所以 navigator.webdriver 保持为 false,而引擎会把常见的 CDP 副作用挡在页面之外。
通往原始 CDP 的出口
get_cdp_endpoint 返回浏览器的 CDP URL,脚本可以接手智能体正在使用的同一个会话。
最新构建,一个变量搞定
加上 CLEARCOTE_LICENSE_KEY,即可运行最新的授权版构建,而不是开源版构建。
MCP 服务器如何工作
服务器启动一个 Clearcote 浏览器,并在自身运行期间一直保留它。每次工具调用都作用于这个共享的浏览器:模型以文本或 markdown 形式读取页面,列出可见的链接、按钮和输入框(能给出 CSS 选择器的都附上),再用这些选择器进行操作,所以它很少需要自己写选择器。
身份在服务器启动时就已固定。身份画像的基础项(种子、平台、品牌、语言、时区、代理和 geoip)都是 CLEARCOTE_* 变量,所以一个服务器条目就是一个身份,没有任何工具能在任务进行到一半时修改它。其余的指纹参数,请直接使用 SDK。
让模型掌控 Clearcote 有两种方式。这个服务器把模型放在浏览器之外,通过调用工具来操作。浏览器内置智能体则运行在浏览器进程内部,与你选择的兼容 OpenAI 的端点通信。
最常用的工具
| 工具 | 作用 |
|---|---|
read_page | 以文本或 markdown 形式读取实时页面 |
page_elements | 列出最多 200 个可见的链接、按钮和输入框,能给出 CSS 选择器的都附上 |
click | 点击一个元素 |
fill_field | 在输入框或文本区域中输入 |
screenshot_page | 整页 PNG 截图,保存到服务器的写入目录 |
navigate | 在当前标签页中加载 URL,并返回最终的 URL 和标题 |
save_profile | 把 cookie 和存储保存到一个命名文件,以便稍后恢复 cookie |
get_cdp_endpoint | 返回供原始客户端使用的 CDP URL |
此外还有 get_page_html、press_key、wait_for、evaluate_js、current_page、get_cookies、list_tabs、new_tab、close_tab、load_profile、get_egress_info 和 save_page_pdf(仅限无头模式)。
典型用途
用真实浏览器做研究
让模型阅读需要 JavaScript 才能渲染的页面,而不是只抓取纯文本。
日常网页杂务
注册、设置页面和控制台,这些原本需要你手动一路点下去的操作。
借助助手调试
让 Cursor 在你的预发布站点上复现一个 bug,并为每一步截图。
自动化原型开发
先和模型一起把流程走一遍,再拿到 CDP 端点,把它写成脚本。
Clearcote 专为隐私保护、测试、研究和合法自动化而打造。你须对自己的使用方式负责,并遵守所访问网站的条款。
哪些套餐包含此功能
MCP 服务器在所有套餐中都免费。除非找到许可证密钥(CLEARCOTE_LICENSE_KEY,或由 clearcote login 保存的密钥),否则它运行开源版构建;免费的 GitHub 密钥可以运行最新构建,同一时间一个浏览器。
常见问题
它支持哪些 MCP 客户端?
从配置文件启动 MCP 服务器的客户端都可以。上面展示的是 Claude Desktop,Cursor 和 Cline 的配置格式与之相同。
模型能控制指纹吗?
不能。身份在服务器启动时由环境变量决定,没有任何工具能修改它。这样身份画像在整个会话中保持一致,工具列表也更精简。
需要 Node 还是 Python?
无论哪种方式,都需要 Python 3.10 或更高版本:npm 包只是同一个 Python 服务器的启动器。按照上面的安装代码块用 pip 安装,并把 mcp 锁定在 2.0 以下(clearcote-mcp 0.1.0 无法在 mcp 2.x 上运行),然后把 clearcote-mcp 或 npx -y clearcote-mcp 作为命令。
它和浏览器内置智能体有什么区别?
MCP 服务器让外部模型(你聊天客户端里的那个)通过工具驱动浏览器。浏览器内置智能体则运行在浏览器内部,调用你配置的模型端点。两者驱动的是同一个引擎。
脚本能接管智能体的会话吗?
可以。get_cdp_endpoint 会返回智能体正在使用的浏览器的 CDP URL,Playwright 或 Puppeteer 可以连接上去。
在文档中深入了解
相关功能
为 browser-use、Stagehand、Crawl4AI 或你自己的智能体提供具备引擎层面身份控制的 Chromium,或者用你自己的模型运行 Clearcote 需主动开启的浏览器内置智能体。
通过官方 Docker 镜像、serve() 或 CLI,把 Clearcote 作为常驻 CDP 端点运行,任何框架都能直接连接,无需改代码。
一次 API 调用即可在云端启动 Clearcote 浏览器,并通过 CDP 连接 Playwright 或 Puppeteer。含住宅 IP,按流量(GB)计费。
Canvas、WebGL、WebGPU、音频、字体、屏幕和硬件都由 C++ 引擎从一个种子派生,区域设置和时区也随之匹配,让每个检测面彼此一致。
相关阅读
试用 Clearcote
可直接接入 Playwright 与 Puppeteer,一直到 TLS 握手都保持一致,并提供开源构建作为起点。
通过 GitHub 可免费使用一个浏览器。无需信用卡。