关于 thinkrun
ThinkRun 是用于控制真实 Chrome 并为 AI 编码 Agent 记录浏览器会话的 MCP 服务和 CLI。它将点击、控制台与网络活动、语音旁白和截图整理为结构化上下文,并可生成 Markdown 或 JSON 报告。
主要功能
- 01控制真实 Chrome 会话
- 02同步记录浏览器活动
- 03捕获点击、控制台和网络信息
- 04生成结构化会话报告
- 05以 Markdown 或 JSON 分享报告
- 06提供六种可移植 Agent 技能
适用场景
- 01为 Agent 提供浏览器故障上下文
- 02通过前后截图验证界面改动
- 03以编程方式浏览和提取信息
- 04生成结构化 UX 审计报告
MCP 相关
ThinkRun 通过 MCP 服务提供浏览器控制和会话记录功能,可添加到 MCP 客户端。原生主机支持操作真实 Chrome,包括现有 Cookie 和登录会话。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
ThinkRun — 面向 AI 编码 Agent 的屏幕录制工具
别再截图记录 Bug,也别再打字写长篇说明。ThinkRun 可以录制任意浏览器会话,也可以让你的 Agent 录下它构建的内容,并将其转化为AI 编码 Agent 可据此采取行动的结构化上下文:每次点击、控制台、网络请求、语音旁白和截图,全部按时间同步。不只是截图,也不只是视频。
适用于 Claude Code、Cursor、Cline、Windsurf 和任意 MCP 客户端。
安装
npx @thinkrun/mcp
也可以全局安装 CLI:
npm install -g @thinkrun/cli
CLI 会自动安装原生宿主二进制文件,让 AI 工具能够控制 Chrome。
添加到 MCP 配置
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": ["@thinkrun/mcp"]
}
}
}
配置位置:
- Claude Code:
~/.claude/settings.json - Cursor:
.cursor/mcp.json - Cline:VS Code 设置 → Cline MCP Servers
然后让你的 Agent 执行:“导航到 localhost:3000 并截取结账页面的截图”——或者你亲自录下 Bug,再把结果交给 Agent。
为什么选择 ThinkRun
其他工具让 Agent 看见页面。ThinkRun 赋予它结构化的视觉能力——它可以一次解析上下文,无需你反复解释页面内容。
| ThinkRun | Playwright MCP | |
|---|---|---|
| 将会话录制为结构化、可回放的上下文 | ✅ | ❌ 仅可驱动 |
| 将录制内容转化为 AI 就绪报告(点击、控制台、网络) | ✅ | ❌ |
| 可分享链接,也支持适用于大模型的 Markdown / JSON | ✅ | ❌ |
| 使用你的真实 Chrome——包括你的 Cookie 和会话 | ✅ | ❌ 仅无头模式 |
| 与你的浏览器并行运行,不会发生配置文件冲突 | ✅ | ❌ 会争用 Chrome 配置文件 |
面向 Claude Code、Cursor、Codex 和 Gemini CLI 的 Agent 技能
此仓库提供六个可移植的 Agent 技能,并为每种主流 Agent 框架提供镜像(.claude/skills/、.cursor/skills/、.codex/skills/、.gemini/skills/):
- prove-it — 软件工厂工作流中的验证步骤:输入命名的测试目标;输出包含通过/失败表格,以及每个目标对应的截图、控制台和网络捕获,并发布到 PR;任何未通过的行都会让变更退回构建阶段。
- before-after — 发布步骤:在相同视口下进行两次捕获,为 PR 生成一个
| Before | After |表格,不使用公开粘贴托管服务。 - web-browse — 以编程方式浏览网页:驱动真实或云端浏览器进行导航、交互、提取和截图。
- ux-audit — 以真实用户的方式浏览产品 UI,为每个步骤截图,并生成包含优先级修复清单的结构化 UX 报告。
- thinkbrowse-cli — 通过
thinkrunCLI 使用 Shell 脚本驱动浏览器。 - thinkbrowse-mcp — 通过 ThinkRun MCP 服务的工具驱动浏览器。
无需克隆即可安装——此仓库以实时 MCP 服务的形式提供,每次提交都会自动更新:
{ "mcpServers": { "thinkrun-skills": { "url": "https://mcp.skillsovermcp.com/mcp/dundas/thinkrun" } } }
触发准确率有实测数据,而非空口宣称。 每项技能都附带一个包含 20 个查询的触发评估测试集,evals/BENCHMARK.md 公布了结果:在六技能目录(v4,2026-09-18)中,GPT-5.6-terra 和 Claude Fable 5 均为 120/120,Claude Sonnet 5 为 113/120(这是其有文档记录的严格 MCP 解读导致的结果,并非崩溃);此前的四技能矩阵在 16 种模型配置中的 12 种上达到 79–80/80。目录消融测试表明,当仅安装部分技能时,浏览技能会相互承接彼此的流量;而 prove-it 填补的是空缺,并非重复同类技能(缺少 before-after 时,其功能会并入 prove-it)。使用 bun evals/run-eval.ts build 复现。
手动安装二进制文件
如果你需要在不使用 CLI 的情况下安装原生宿主,请从最新版本下载适用于你平台的二进制文件,然后运行:
chmod +x thinkbrowse-host-* && ./thinkbrowse-host-* --install
原生宿主二进制文件目前仍沿用
thinkbrowse-host文件名——它是同一个已签名的二进制文件,重命名未对其作任何更改。
常见问题
如何让 Claude Code(或 Cursor)访问我的浏览器?
将 ThinkRun 添加为 MCP 服务——npx @thinkrun/mcp——你的 Agent 就能操控并读取真实的 Chrome 会话,包括你的 Cookie 和登录状态。请参阅上文“添加到 MCP 配置”。
如何向 Cursor 展示 UI 错误,而不是粘贴截图?
使用 ThinkRun 录制错误。你的 Agent 获得的不是一张静态图片,而是一份结构化记录——你执行的步骤、控制台错误、失败的网络请求,以及出现错误时的 DOM 状态——这样它就能修复实际问题,而不是看图猜测。
有没有能使用我真实 Chrome Cookie 和会话的 MCP 服务?
有。ThinkRun 通过原生主机连接你的真实 Chrome,因此已通过身份验证的页面可以直接使用——无需在无头浏览器中重新登录,无需单独的配置文件,也无需与浏览器争用 Chrome 配置文件。
如何为 AI 编码 Agent 录制浏览器会话?
运行 npx @thinkrun/mcp(或 npm i -g @thinkrun/cli),录制任意会话——也可以让 Agent 录制它构建的内容。ThinkRun 会将其转为适用于 AI 的报告(点击、控制台、网络、旁白、截图,全部按时间同步),并以可分享链接以及适用于大模型的 Markdown/JSON 格式提供。
如何让 AI 编码 Agent 了解出了什么问题?
把 ThinkRun 录制内容交给它。结构化的“发生了什么”——操作、首个异常信号、预期与实际结果,以及元素状态——正是 Agent 一次就能修复问题所需的上下文。
更多
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。