peek — Claude Code MCP server: what it does, how to install
peek lets an AI coding agent inspect locally recorded browser sessions and turn a failure into a reproducible Playwright test.
claude mcp add peek-mcp -- npx -y @peekdev/mcpWhat peek does
peek exposes captured browser evidence to an AI coding agent: DOM history, console and network failures, plus the user action immediately before an error. The server reads session data from SQLite and can build a runnable Playwright reproduction from it.
It runs locally over stdio rather than serving an HTTP endpoint. A Chrome extension records the sessions, while @peekdev/cli connects the recorder to the MCP setup. Run peek init once and install the extension before there is anything for the server to inspect.
Node.js 22 or newer is required because better-sqlite3 needs a matching native build. On Node.js 20, installation can fall back to compilation and fail, especially on Windows.
What it helps with
- find the session behind a browser error
- trace the user action before a failure
- inspect console and network failures
- generate a reproducible Playwright test
Example prompts for the agent
- Find the latest recorded session with a console error and explain the failure.
- Show the network failures and the user action immediately before the error.
- Create a Playwright test that reproduces the failure from the latest session.
How to install peek
Platform CLI
claude mcp add peek-mcp -- npx -y @peekdev/mcpPlatform CLI
codex mcp add peek-mcp -- npx -y @peekdev/mcpConfig file
{
"mcpServers": {
"peek-mcp": {
"command": "npx",
"args": [
"-y",
"@peekdev/mcp"
]
}
}
}Config file
{
"servers": {
"peek-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peekdev/mcp"
]
}
}
}Platform CLI
gemini mcp add peek-mcp npx -y @peekdev/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about peek
How do I install peek in Claude Code?
Run claude mcp add peek-mcp -- npx -y @peekdev/mcp. To record sessions, also run peek init once and install the peek Chrome extension.
What does peek do?
It gives an AI coding agent access to locally recorded browser sessions, including DOM changes, console errors, network failures, and the action before an error. It can turn a session into a Playwright reproduction.
What does peek require?
Use Node.js 22 or newer. Session capture also needs the Chrome extension and a one-time peek init setup.
