Ermöglicht es AI Coding Agents, echte Chrome-Sessions aufzuzeichnen, zu durchsuchen und zu analysieren – inklusive strukturiertem Kontext wie Klicks, Console Logs und Network Requests.
Auch bekannt als dundas/thinkrun, @thinkrun/mcp
- Stars
- 2
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.3.14
- Letzter Commit
- 9. Nov. 2026
- Lizenz
- MIT
Was ist ThinkRun MCP?
Ermöglicht es AI Coding Agents, echte Chrome-Sessions aufzuzeichnen, zu durchsuchen und zu analysieren – inklusive strukturiertem Kontext wie Klicks, Console Logs und Network Requests.
Zusammenfassung generiert aus dem README des Projekts
Über ThinkRun MCP server
ThinkRun verleiht AI Coding Agents eine strukturierte Sichtweise, indem es echte Chrome-Sessions aufzeichnet. Anstatt sich auf statische Screenshots zu verlassen, können Entwickler den Agenten zeitlich synchronisierten Kontext liefern, der Klicks, Console Logs, Network Requests und Sprachkommentare umfasst. Dieser Server funktioniert mit gängigen MCP Clients wie Claude Code, Cursor, Cline und Windsurf. Er nutzt eine native Host-Binary, um mit deinem tatsächlichen Chrome-Browser zu interagieren, was bedeutet, dass er auf deine vorhandenen Cookies und authentifizierten Sessions zugreifen kann, ohne Profilkonflikte zu verursachen.
Der Server enthält sieben portable Agent Skills, die für spezifische Development-Workflows entwickelt wurden. Dazu gehören web-browse für die programmatische Navigation, ux-audit zur Erstellung strukturierter UI-Reports und prove-it für automatisiertes Software-Factory-Testing. Nutzer können den Server via npx installieren oder das CLI global über npm installieren. Dieses Setup ermöglicht es einem Agenten, lokale Umgebungen wie localhost:3000 zu navigieren oder komplexe Bugs durch detaillierte Markdown- oder JSON-Reports anstatt durch einfache Bilder zu analysieren.
Was du damit machen kannst
- 1Komplexe UI-Errors debuggenGib einem Agenten eine Aufnahme mit Console Errors und Network Requests, um einen Bug zu fixen, anstatt nur einen Screenshot zu senden.
- 2Software-Testing automatisierenNutze den prove-it Skill, um Test-Targets auszuführen und eine Pass/Fail-Tabelle inklusive technischer Belege zu erhalten.
- 3UX-Audits durchführenAnweise einen Agenten, eine Produkt-Oberfläche durchzugehen und eine priorisierte Liste von Fixes zu generieren.
- 4Visuelle Änderungen verifizierenVergleiche das Aussehen einer Seite vor und nach einer Code-Änderung mithilfe von Side-by-Side-Captures.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du ThinkRun MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenThinkRun MCP in Claude Code installieren
$ claude mcp add thinkrun -- npx -y @thinkrun/mcpThinkRun MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}ThinkRun MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"thinkrun": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}ThinkRun MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"thinkrun","type":"stdio","command":"npx","args":["-y","@thinkrun/mcp"]}'ThinkRun MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}ThinkRun MCP in Codex installieren
$ codex mcp add thinkrun -- npx -y @thinkrun/mcpThinkRun MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.thinkrun] command = "npx" args = ["-y", "@thinkrun/mcp"]
ThinkRun MCP in Gemini CLI installieren
$ gemini mcp add -s user thinkrun npx -- -y @thinkrun/mcpThinkRun MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbardundas/thinkrun is public and reachablegithub.com/dundas/thinkrun ↗Bestanden
- Paket nennt dieses Repository als Quelle@thinkrun/mcp names dundas/thinkrun as sourcenpmjs.com/package/@thinkrun/mcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-09github.com/dundas/thinkrun ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @thinkrun/mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten112 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenThinkRun — 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
ThinkRun MCP Fragen
Wie füge ich ThinkRun MCP zu Claude Code hinzu?
Führe claude mcp add thinkrun -- npx -y @thinkrun/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich ThinkRun MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie gebe ich Claude Code (oder Cursor) Zugriff auf meinen Browser?
Füge ThinkRun als MCP server über npx @thinkrun/mcp hinzu, damit dein Agent eine echte Chrome-Session steuern und lesen kann, einschließlich deiner Cookies und Logins.
Wie zeige ich Cursor einen UI-Bug, anstatt nur einen Screenshot einzufügen?
Nimm den Bug mit ThinkRun auf, um dem Agenten ein strukturiertes Artefakt mit den durchgeführten Schritten, Console Errors, fehlgeschlagenen Network Requests und dem DOM-Status zur Verfügung zu stellen.
Gibt es einen MCP server, der meine echten Chrome-Cookies und Sessions nutzt?
Ja, ThinkRun läuft über einen nativen Host direkt in deinem echten Chrome. So funktionieren authentifizierte Seiten, ohne dass ein Headless-Re-Login oder Profilkonflikte entstehen.
Wie zeichne ich eine Browser-Session für einen AI Coding Agent auf?
Führe npx @thinkrun/mcp aus oder installiere das CLI global, um dann eine Session aufzuzeichnen. So generierst du einen KI-bereiten Report mit zeitlich synchronisierten Klicks, Console- und Network-Daten.