Permite que los agentes de codificación con IA graben, naveguen y analicen sesiones reales de Chrome con contexto estructurado que incluye clics, logs de la consola y peticiones de red.
También conocido como dundas/thinkrun, @thinkrun/mcp
- Stars
- 2
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.3.14
- Último commit
- 9 nov 2026
- Licencia
- MIT
¿Qué es ThinkRun MCP?
Permite que los agentes de codificación con IA graben, naveguen y analicen sesiones reales de Chrome con contexto estructurado que incluye clics, logs de la consola y peticiones de red.
Resumen generado a partir del README del proyecto
Acerca del MCP server de ThinkRun
ThinkRun proporciona visión estructurada a los agentes de codificación con IA mediante la grabación de sesiones reales de Chrome. En lugar de depender de capturas de pantalla estáticas, los desarrolladores pueden ofrecer a los agentes un contexto sincronizado en el tiempo que incluye clics, logs de la consola, peticiones de red y narración de voz. Este server funciona con clientes MCP populares como Claude Code, Cursor, Cline y Windsurf. Utiliza un binario de host nativo para interactuar con tu navegador Chrome real, lo que significa que puede acceder a tus cookies existentes y sesiones autenticadas sin conflictos de perfil.
El server incluye siete Agent Skills portátiles diseñadas para flujos de trabajo de desarrollo específicos. Estos incluyen web-browse para navegación programática, ux-audit para generar reportes de UI estructurados y prove-it para pruebas automatizadas de software-factory. Los usuarios pueden instalar el server vía npx o instalar el CLI globalmente usando npm. Esta configuración permite que un agente navegue hacia entornos locales como localhost:3000 o analice errores complejos mediante reportes detallados en Markdown o JSON en lugar de simples imágenes.
Qué puedes hacer con él
- 1Depurar errores de UI complejosProporciona a un agente una grabación que contenga errores de consola y peticiones de red para solucionar un bug en lugar de solo una captura de pantalla.
- 2Automatizar pruebas de softwareUsa la skill prove-it para ejecutar objetivos de prueba y recibir una tabla de aprobado/reprobado con capturas técnicas de respaldo.
- 3Realizar auditorías de UXInstruye a un agente para que recorra la interfaz de un producto y genere una lista priorizada de correcciones.
- 4Verificar cambios visualesCompara la apariencia de una página antes y después de un cambio de código usando capturas comparativas.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar ThinkRun MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar ThinkRun MCP en Claude Code
$ claude mcp add thinkrun -- npx -y @thinkrun/mcpInstalar ThinkRun MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}Instalar ThinkRun MCP en VS Code
.vscode/mcp.json
{
"servers": {
"thinkrun": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}Instalar ThinkRun MCP en VS Code CLI
$ code --add-mcp '{"name":"thinkrun","type":"stdio","command":"npx","args":["-y","@thinkrun/mcp"]}'Instalar ThinkRun MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}Instalar ThinkRun MCP en Codex
$ codex mcp add thinkrun -- npx -y @thinkrun/mcpInstalar ThinkRun MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.thinkrun] command = "npx" args = ["-y", "@thinkrun/mcp"]
Instalar ThinkRun MCP en Gemini CLI
$ gemini mcp add -s user thinkrun npx -- -y @thinkrun/mcpInstalar ThinkRun MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibledundas/thinkrun is public and reachablegithub.com/dundas/thinkrun ↗Aprobado
- El paquete indica este repositorio como su origen@thinkrun/mcp names dundas/thinkrun as sourcenpmjs.com/package/@thinkrun/mcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-09github.com/dundas/thinkrun ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @thinkrun/mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias112 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubThinkRun — Screen Recorder for AI Coding Agents
Stop screenshotting bugs and typing paragraphs to explain them. ThinkRun records any browser session — or lets your agent record what it built — and turns it into structured context your AI coding agent can act on: every click, the console, network requests, your voice narration, and screenshots, all time-synced. Not just a screenshot. Not just a video.
Works with Claude Code, Cursor, Cline, Windsurf, and any MCP client.
Install
npx @thinkrun/mcp
Or install the CLI globally:
npm install -g @thinkrun/cli
The CLI automatically installs the native host binary, which lets AI tools control Chrome.
Add to your MCP config
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": ["@thinkrun/mcp"]
}
}
}
Config location:
- Claude Code:
~/.claude/settings.json - Cursor:
.cursor/mcp.json - Cline: VS Code settings → Cline MCP Servers
Then ask your agent: "navigate to localhost:3000 and screenshot the checkout page" — or record the bug yourself and hand the agent the result.
Why ThinkRun
Other tools give your agent eyes. ThinkRun gives it structured sight — context it can parse in one pass instead of you re-explaining the page.
| ThinkRun | Playwright MCP | |
|---|---|---|
| Records a session into structured, replayable context | ✅ | ❌ drive-only |
| Turns a recording into an AI-ready report (clicks, console, network) | ✅ | ❌ |
| Shareable link, also as LLM-ready Markdown / JSON | ✅ | ❌ |
| Uses your real Chrome — your cookies & sessions | ✅ | ❌ headless only |
| Runs alongside your browser, no profile conflict | ✅ | ❌ fights for Chrome profile |
Agent skills for Claude Code, Cursor, Codex & Gemini CLI
Seven portable agent skills ship in this repo, mirrored for every major harness (.claude/skills/, .cursor/skills/, .codex/skills/, .gemini/skills/):
- prove-it — the prove step of a software-factory workflow: named test targets in, a pass/fail table with a screenshot, console and network capture per target out, posted to the PR; any non-pass row sends the change back to build.
- before-after — the ship step: two captures at the same viewport, one
| Before | After |table for the PR, no public paste host. - web-browse — browse the web programmatically: drive a real or cloud browser to navigate, interact, extract, and screenshot.
- ux-audit — walk through a product UI as a real user, screenshot every step, and produce a structured UX report with a prioritized fix list.
- thinkbrowse-cli — drive the browser from shell scripts via the
thinkrunCLI. - thinkbrowse-mcp — drive the browser through the ThinkRun MCP server's tools.
- browser-tool-benchmark — run the open Playwright CLI vs MCP benchmark on your own agent and model, and get tokens, cost, speed and pass rate per setup next to the published results.
Install without cloning — the repo is served as a live MCP server that auto-updates on every commit:
{ "mcpServers": { "thinkrun-skills": { "url": "https://mcp.skillsovermcp.com/mcp/dundas/thinkrun" } } }
Trigger accuracy is measured, not claimed. Every skill ships a 20-query trigger-eval fixture, and evals/BENCHMARK.md publishes the results: with the seven-skill catalog (v5, 2026-11-09), 140/140 on GPT-6 Luna, Claude Sonnet 5.5 and Claude Opus 5.5; with the six-skill catalog (v4, 2026-09-18), 120/120 on GPT-5.6-terra and Claude Fable 5 and 113/120 on Claude Sonnet 5 (its documented strict-MCP reading, not a crash); the earlier four-skill matrix scored 79–80/80 on 12 of 16 model configurations. Catalog-ablation runs show the browsing skills absorb each other's traffic when installed as a subset, and that prove-it fills a gap rather than duplicating a sibling (before-after folds into prove-it when absent). Reproduce with bun evals/run-eval.ts build.
Manual binary install
If you need to install the native host without the CLI, download the binary for your platform from the latest release and run:
chmod +x thinkbrowse-host-* && ./thinkbrowse-host-* --install
The native host binary keeps the
thinkbrowse-hostfilename for now — it's the same signed binary, unchanged by the rename.
FAQ
How do I give Claude Code (or Cursor) access to my browser?
Add ThinkRun as an MCP server — npx @thinkrun/mcp — and your agent can drive and read a real Chrome session, your cookies and logins included. See "Add to your MCP config" above.
How do I show Cursor a UI bug instead of pasting a screenshot?
Record the bug with ThinkRun. Instead of a flat image, your agent gets a structured artifact — the steps you took, the console errors, the failing network requests, and the DOM state at the moment it broke — so it fixes the actual problem instead of guessing from a picture.
Is there an MCP server that uses my real Chrome cookies and sessions?
Yes. ThinkRun runs against your real Chrome via a native host, so authenticated pages just work — no headless re-login, no separate profile, no fighting your browser for the Chrome profile.
How do I record a browser session for an AI coding agent?
Run npx @thinkrun/mcp (or npm i -g @thinkrun/cli) and record any session — or let the agent record what it built. ThinkRun turns it into an AI-ready report (clicks, console, network, narration, screenshots, all time-synced), available as a shareable link and as LLM-ready Markdown/JSON.
How do I give my AI coding agent context about what went wrong?
Hand it a ThinkRun recording. The structured "what happened" — actions, first bad signal, expected vs actual, and the element state — is exactly the context an agent needs to land a fix on the first try.
Benchmarks
- Playwright CLI vs MCP: 285 tests on Claude Sonnet 5.5, GPT-6 Luna and GPT-6.1 Sol, with the test shop, prompts, runners, results and the scripts that recompute every published number (video, blog post, ThinkRun analysis of the video)
More
Preguntas sobre ThinkRun MCP
¿Cómo agrego ThinkRun MCP a Claude Code?
Ejecuta claude mcp add thinkrun -- npx -y @thinkrun/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego ThinkRun MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo le doy acceso a mi navegador a Claude Code (o Cursor)?
Añade ThinkRun como un MCP server usando npx @thinkrun/mcp para permitir que tu agente controle y lea una sesión real de Chrome, incluyendo tus cookies y sesiones iniciadas.
¿Cómo le muestro un error de UI a Cursor en lugar de pegar una captura de pantalla?
Graba el error con ThinkRun para proporcionar al agente un artefacto estructurado que contenga los pasos realizados, errores de consola, peticiones de red fallidas y el estado del DOM.
¿Existe algún MCP server que utilice mis cookies y sesiones reales de Chrome?
Sí, ThinkRun se ejecuta sobre tu Chrome real mediante un host nativo, lo que permite que las páginas autenticadas funcionen sin necesidad de volver a iniciar sesión en modo headless o tener conflictos de perfil.
¿Cómo grabo una sesión de navegador para un agente de codificación con IA?
Ejecuta npx @thinkrun/mcp o instala el CLI de forma global, luego graba una sesión para generar un reporte listo para IA con clics, consola y datos de red sincronizados en el tiempo.