Yapay zeka kodlama ajanlarının tıklamalar, konsol günlükleri ve ağ istekleri gibi yapılandırılmış bağlamlar içeren gerçek Chrome oturumlarını kaydetmesine, taramasına ve analiz etmesine olanak tanır.
Ayrıca bilinen adı dundas/thinkrun, @thinkrun/mcp
- Yıldızlar
- 2
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.3.14
- Son commit
- 9 Kas 2026
- Lisans
- MIT
ThinkRun MCP nedir?
Yapay zeka kodlama ajanlarının tıklamalar, konsol günlükleri ve ağ istekleri gibi yapılandırılmış bağlamlar içeren gerçek Chrome oturumlarını kaydetmesine, taramasına ve analiz etmesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
ThinkRun MCP sunucusu hakkında
ThinkRun, gerçek Chrome oturumlarını kaydederek yapay zeka kodlama ajanlarına yapılandırılmış bir görüş yeteneği kazandırır. Geliştiriciler, statik ekran görüntülerine güvenmek yerine ajanlara tıklamalar, konsol günlükleri, ağ istekleri ve sesli anlatım içeren zaman senkronizasyonlu bağlamlar sağlayabilirler. Bu server; Claude Code, Cursor, Cline ve Windsurf gibi popüler MCP istemcileriyle çalışır. Mevcut Chrome tarayıcınızla etkileşime girmek için yerel bir host binary kullanır, bu da profil çakışması yaşamadan mevcut çerezlerinize ve oturum açılmış sayfalarınıza erişebileceği anlamına gelir.
Server, belirli geliştirme iş akışları için tasarlanmış yedi taşınabilir agent skill içerir. Bunlar arasında programatik navigasyon için web-browse, yapılandırılmış UI raporları oluşturmak için ux-audit ve otomatik yazılım fabrikası testleri için prove-it bulunur. Kullanıcılar server'ı npx ile kurabilir veya npm kullanarak CLI aracını global olarak yükleyebilirler. Bu kurulum, bir ajanın localhost:3000 gibi yerel ortamlarda gezinmesine veya karmaşık hataları basit görseller yerine ayrıntılı Markdown veya JSON raporları aracılığıyla analiz etmesine olanak tanır.
Neler yapabilirsiniz
- 1Karmaşık UI hatalarını ayıklayınBir hatayı düzeltmek için ajana sadece bir ekran görüntüsü yerine konsol hatalarını ve ağ isteklerini içeren bir kayıt sunun.
- 2Yazılım testlerini otomatize edinTest hedeflerini çalıştırmak ve destekleyici teknik verilerle birlikte bir geçti/kaldı tablosu almak için prove-it skill özelliğini kullanın.
- 3UX denetimleri gerçekleştirinBir ajana bir ürün arayüzünü incelemesi ve önceliklendirilmiş bir düzeltme listesi oluşturması talimatını verin.
- 4Görsel değişiklikleri doğrulayınYan yana karşılaştırmalı kayıtlar kullanarak bir sayfanın görünümünü kod değişikliğinden önce ve sonra karşılaştırın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
ThinkRun MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleThinkRun MCP'yi Claude Code içine yükleyin
$ claude mcp add thinkrun -- npx -y @thinkrun/mcpThinkRun MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}ThinkRun MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"thinkrun": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}ThinkRun MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"thinkrun","type":"stdio","command":"npx","args":["-y","@thinkrun/mcp"]}'ThinkRun MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}ThinkRun MCP'yi Codex içine yükleyin
$ codex mcp add thinkrun -- npx -y @thinkrun/mcpThinkRun MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.thinkrun] command = "npx" args = ["-y", "@thinkrun/mcp"]
ThinkRun MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user thinkrun npx -- -y @thinkrun/mcpThinkRun MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirdundas/thinkrun is public and reachablegithub.com/dundas/thinkrun ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@thinkrun/mcp names dundas/thinkrun as sourcenpmjs.com/package/@thinkrun/mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-09github.com/dundas/thinkrun ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @thinkrun/mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok112 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
ThinkRun — 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 soruları
ThinkRun MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add thinkrun -- npx -y @thinkrun/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
ThinkRun MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Claude Code (veya Cursor) uygulamasına tarayıcı erişimi nasıl veririm?
Ajanınızın çerezleriniz ve oturum açılmış hesaplarınız dahil olmak üzere gerçek bir Chrome oturumunu yönetmesini ve okumasını sağlamak için npx @thinkrun/mcp komutunu kullanarak ThinkRun'ı bir MCP server olarak ekleyin.
Cursor'a bir ekran görüntüsü yapıştırmak yerine bir UI hatasını nasıl gösteririm?
Hatanın izlenen adımlarını, konsol hatalarını, başarısız ağ isteklerini ve DOM durumunu içeren yapılandırılmış bir veri seti sağlamak için hatayı ThinkRun ile kaydedin.
Gerçek Chrome çerezlerimi ve oturumlarımı kullanan bir MCP server var mı?
Evet, ThinkRun yerel bir host aracılığıyla gerçek Chrome'unuz üzerinde çalışır; bu sayede kimlik doğrulaması yapılmış sayfalar, headless modda tekrar giriş yapmaya gerek kalmadan veya profil çakışması yaşamadan çalışabilir.
Yapay zeka kodlama ajanı için tarayıcı oturumu nasıl kaydedilir?
npx @thinkrun/mcp komutunu çalıştırın veya CLI aracını global olarak yükleyin, ardından zaman senkronizasyonlu tıklamalar, konsol ve ağ verileri içeren, yapay zekaya hazır bir rapor oluşturmak için bir oturum kaydedin.