AIコーディングエージェントが、クリック、コンソールログ、ネットワークリクエストなどの構造化されたコンテキストを含む、実際のChromeセッションを記録、閲覧、分析できるようにします。
別名 dundas/thinkrun, @thinkrun/mcp
- スター
- 2
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.3.14
- 最終コミット
- 2026年11月9日
- ライセンス
- MIT
ThinkRun MCPとは
AIコーディングエージェントが、クリック、コンソールログ、ネットワークリクエストなどの構造化されたコンテキストを含む、実際のChromeセッションを記録、閲覧、分析できるようにします。
プロジェクトのREADMEから生成された概要
ThinkRun MCP server について
ThinkRunは、実際のChromeセッションを記録することで、AIコーディングエージェントに構造化された視覚情報を提供します。静的なスクリーンショットに頼る代わりに、クリック、コンソールログ、ネットワークリクエスト、音声ナレーションを含む、時間同期されたコンテキストをエージェントに提供できます。このserverは、Claude Code、Cursor、Cline、Windsurfなどの主要なMCPクライアントに対応しています。ネイティブホストバイナリを使用して実際のChromeブラウザと対話するため、プロファイルの競合を起こすことなく、既存のCookieや認証済みセッションにアクセスできます。
このserverには、特定の開発ワークフロー向けに設計された7つのポータブルなAgent Skillsが含まれています。これには、プログラムによるナビゲーションを行うweb-browse、構造化されたUIレポートを生成するux-audit、自動化されたソフトウェアファクトリテストを行うprove-it などがあります。ユーザーは npx を介してserverをインストールするか、npmを使用してCLIをグローバルにインストールできます。このセットアップにより、エージェントは localhost:3000 のようなローカル環境へ移動したり、単純な画像ではなく詳細なMarkdownやJSONレポートを通じて複雑なバグを分析したりすることが可能になります。
できること
- 1複雑なUIエラーのデバッグ単なるスクリーンショットの代わりに、コンソールエラーやネットワークリクエストを含む記録をエージェントに提供してバグを修正します。
- 2ソフトウェアテストの自動化prove-it スキルを使用してテスト対象を実行し、技術的なキャプチャを添えた合否判定テーブルを受け取ります。
- 3UX監査の実施エージェントに製品インターフェースを操作させ、優先順位付けされた修正リストを生成させます。
- 4ビジュアル変更の検証コード変更前後のページの見た目を、サイドバイサイドのキャプチャを使用して比較します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
ThinkRun MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにThinkRun MCPをインストール
$ claude mcp add thinkrun -- npx -y @thinkrun/mcpCursorにThinkRun MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}VS CodeにThinkRun MCPをインストール
.vscode/mcp.json
{
"servers": {
"thinkrun": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}VS Code CLIにThinkRun MCPをインストール
$ code --add-mcp '{"name":"thinkrun","type":"stdio","command":"npx","args":["-y","@thinkrun/mcp"]}'Claude DesktopにThinkRun MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}CodexにThinkRun MCPをインストール
$ codex mcp add thinkrun -- npx -y @thinkrun/mcpCodex config.tomlにThinkRun MCPをインストール
~/.codex/config.toml
[mcp_servers.thinkrun] command = "npx" args = ["-y", "@thinkrun/mcp"]
Gemini CLIにThinkRun MCPをインストール
$ gemini mcp add -s user thinkrun npx -- -y @thinkrun/mcpGemini settings.jsonにThinkRun MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": [
"-y",
"@thinkrun/mcp"
]
}
}
}自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能dundas/thinkrun is public and reachablegithub.com/dundas/thinkrun ↗合格
- パッケージがこのリポジトリをソースとして指定@thinkrun/mcp names dundas/thinkrun as sourcenpmjs.com/package/@thinkrun/mcp ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-09github.com/dundas/thinkrun ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @thinkrun/mcp合格
- パッケージおよびその依存関係に重大な勧告なし112 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見る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のよくある質問
ThinkRun MCPをClaude Codeに追加するには
ターミナルでclaude mcp add thinkrun -- npx -y @thinkrun/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
ThinkRun MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Claude Code (または Cursor) にブラウザへのアクセス権を与えるにはどうすればよいですか?
npx @thinkrun/mcp を使用して ThinkRun を MCP server として追加してください。これにより、エージェントが実際のChromeセッションを操作・読み取り、Cookieやログイン状態を利用できるようになります。
スクリーンショットを貼り付ける代わりに、CursorにUIのバグを見せるにはどうすればよいですか?
ThinkRunでバグを記録してください。操作手順、コンソールエラー、失敗したネットワークリクエスト、DOMの状態を含む構造化されたアーティファクトをエージェントに提供できます。
実際のChromeのCookieやセッションを使用する MCP server はありますか?
はい、ThinkRunはネイティブホストを介して実際のChrome上で動作するため、ヘッドレス環境での再ログインやプロファイルの競合なしに、認証済みページを利用できます。
AIコーディングエージェント向けにブラウザセッションを記録するにはどうすればよいですか?
npx @thinkrun/mcp を実行するか、CLIをグローバルにインストールしてください。その後、セッションを記録することで、クリック、コンソール、ネットワークデータが時間同期された、AIが利用しやすいレポートを生成できます。