AI 코딩 에이전트가 클릭, 콘솔 로그, 네트워크 요청을 포함한 구조화된 컨텍스트를 통해 실제 Chrome 세션을 기록, 탐색 및 분석할 수 있도록 합니다.
다른 이름 dundas/thinkrun, @thinkrun/mcp
- 스타
- 2
- Tools
- —
- 다운로드, 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 브라우저와 상호 작용하므로, 프로필 충돌 없이 기존 쿠키 및 인증된 세션에 접근할 수 있습니다.
이 server에는 특정 개발 워크플로우를 위해 설계된 7가지 휴대용 Agent Skills가 포함되어 있습니다. 여기에는 프로그래밍 방식의 탐색을 위한 web-browse, 구조화된 UI 보고서 생성을 위한 ux-audit, 자동화된 소프트웨어 팩토리 테스트를 위한 prove-it 등이 있습니다. 사용자는 npx를 통해 server를 설치하거나 npm을 사용하여 CLI를 전역으로 설치할 수 있습니다. 이 설정을 통해 에이전트는 localhost:3000과 같은 로컬 환경으로 이동하거나, 단순한 이미지가 아닌 상세한 Markdown 또는 JSON 보고서를 통해 복잡한 버그를 분석할 수 있습니다.
활용 사례
- 1복잡한 UI 에러 디버깅단순한 스크린샷 대신 콘솔 에러와 네트워크 요청이 포함된 기록을 에이전트에게 제공하여 버그를 수정합니다.
- 2소프트웨어 테스트 자동화prove-it SKILL을 사용하여 테스트 대상을 실행하고 기술적 캡처가 포함된 합격/불합격 테이블을 받습니다.
- 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Claude Code(또는 Cursor)에 브라우저 접근 권한을 어떻게 부여하나요?
npx @thinkrun/mcp를 사용하여 ThinkRun을 MCP server로 추가하면, 에이전트가 쿠키와 로그인 정보를 포함한 실제 Chrome 세션을 제어하고 읽을 수 있습니다.
스크린샷을 붙여넣는 대신 Cursor에 UI 버그를 어떻게 보여주나요?
ThinkRun으로 버그를 기록하면 수행 단계, 콘솔 에러, 실패한 네트워크 요청 및 DOM 상태를 포함한 구조화된 결과물을 에이전트에게 제공할 수 있습니다.
실제 Chrome 쿠키와 세션을 사용하는 MCP server가 있나요?
네, ThinkRun은 네이티브 호스트를 통해 실제 Chrome에서 실행되므로, 헤드리스 환경에서의 재로그인이나 프로필 충돌 없이 인증된 페이지를 사용할 수 있습니다.
AI 코딩 에이전트를 위해 브라우저 세션을 어떻게 기록하나요?
npx @thinkrun/mcp를 실행하거나 CLI를 전역으로 설치한 후 세션을 기록하면, 시간 동기화된 클릭, 콘솔 및 네트워크 데이터가 포함된 AI용 보고서를 생성할 수 있습니다.