@vibecheck-mcp/mcp

MCP server for VibeCheck bug reports. Gives AI assistants direct access to screen recordings, console logs, network requests, user actions, and web vitals — right inside your editor.

Just paste a VibeCheck track URL and your AI can analyze the bug report.

Tools

| Tool | Description | Image? | |------|-------------|--------| | get_track | Full bug report — console logs, network, user actions, vitals | Yes (screenshots) | | analyze_track_errors | Focused error analysis — console errors + failed network requests | Yes (screenshots) | | get_track_network | Network deep-dive — failed requests, slow requests, summary table | No | | get_track_performance | Performance report — web vitals, navigation timing, assessment | No | | get_track_actions | User action timeline + auto-generated steps to reproduce | No |

get_track

Fetch and format a complete VibeCheck bug report.

Parameters:

• url_or_id (required) — Track URL or ID
• include (optional) — Sections to include: logs, network, actions, vitals, all

analyze_track_errors

Focused view of errors only — console errors with stack traces and failed network requests with response bodies.

Parameters:

• url_or_id (required) — Track URL or ID

get_track_network

Deep analysis of network requests with failed/slow request detection.

Parameters:

• url_or_id (required) — Track URL or ID
• slow_threshold_ms (optional, default: 1000) — Threshold in ms to flag slow requests
• status_filter (optional, default: all) — Filter: all, errors, success

get_track_performance

Web vitals analysis with ratings and optimization suggestions.

Parameters:

• url_or_id (required) — Track URL or ID

get_track_actions

User action timeline with auto-generated steps to reproduce.

Parameters:

• url_or_id (required) — Track URL or ID
• action_types (optional) — Filter by type: click, input, scroll, navigation, etc.

Screenshot Support

For screenshot tracks, get_track and analyze_track_errors return the screenshot image alongside the text report using MCP's ImageContent type. Video tracks return text data only (no video fetch).

Setup

Claude Code

claude mcp add vibecheck -- npx -y @vibecheck-mcp/mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "vibecheck": {
      "command": "npx",
      "args": ["-y", "@vibecheck-mcp/mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "vibecheck": {
      "command": "npx",
      "args": ["-y", "@vibecheck-mcp/mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "vibecheck": {
      "command": "npx",
      "args": ["-y", "@vibecheck-mcp/mcp"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "vibecheck": {
      "command": "npx",
      "args": ["-y", "@vibecheck-mcp/mcp"]
    }
  }
}

Development

git clone https://github.com/kosbay/vibecheck-mcp.git
cd vibecheck-mcp
npm install
npm run build
npm start

License

MIT