{"_id":"@arwars/simplebug-mcp","_rev":"4-41265929ed2c440078487688de310a5b","name":"@arwars/simplebug-mcp","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.1":{"name":"@arwars/simplebug-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","simplebug","bug-reports","ai"],"license":"MIT","_id":"@arwars/simplebug-mcp@0.1.1","maintainers":[{"name":"arwars","email":"ariieelesteban@gmail.com"}],"homepage":"https://github.com/ArWars/SimpleBug#readme","bugs":{"url":"https://github.com/ArWars/SimpleBug/issues"},"bin":{"simplebug-mcp":"dist/index.js"},"dist":{"shasum":"d25f1985211d7636ff8daec917fe1d4ad2745f64","tarball":"https://registry.npmjs.org/@arwars/simplebug-mcp/-/simplebug-mcp-0.1.1.tgz","fileCount":3,"integrity":"sha512-qFZDvPXGlKzw2Cw2XAh/IkgL6FSVqnrFVf5xteosSkYeQCmONX91NQ6fyL4A/86L3x5Bj9AoK8YTOm65h2lcMg==","signatures":[{"sig":"MEUCIHDhuk9PdjCG5S8RAQzd1DxRjYxQmBa+021CLPe7deDKAiEApZMbEiKIJ9bylD43NOwabh1hJed+g6xEDJuQoTu3ukU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19030},"type":"module","engines":{"node":">=20"},"gitHead":"610311aa0fed4ba63f0ec9e147e71f194c3b0f74","scripts":{"build":"bun build ./src/index.ts --target=node --format=esm --outfile=dist/index.js --external @modelcontextprotocol/sdk --external @orpc/client --external zod","start":"bun run ./src/index.ts","check-types":"tsc --noEmit -p tsconfig.json","prepublishOnly":"bun run build"},"_npmUser":{"name":"arwars","email":"ariieelesteban@gmail.com"},"repository":{"url":"git+https://github.com/ArWars/SimpleBug.git","type":"git","directory":"apps/mcp"},"_npmVersion":"11.11.0","description":"MCP server for SimpleBug — lets AI agents read bug reports (reproduction steps, console logs, network, video frames) to diagnose and fix bugs.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^4.1.13","@orpc/client":"^1.12.2","@modelcontextprotocol/sdk":"1.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5","@simplebug/api":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/simplebug-mcp_0.1.1_1780566292146_0.37830431562885924","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@arwars/simplebug-mcp","version":"0.1.2","description":"MCP server for SimpleBug — lets AI agents read bug reports (reproduction steps, console logs, network, video frames) to diagnose and fix bugs.","license":"MIT","type":"module","bin":{"simplebug-mcp":"dist/index.js"},"engines":{"node":">=20"},"keywords":["mcp","model-context-protocol","simplebug","bug-reports","ai"],"repository":{"type":"git","url":"git+https://github.com/ArWars/SimpleBug.git","directory":"apps/mcp"},"publishConfig":{"access":"public"},"scripts":{"build":"bun build ./src/index.ts --target=node --format=esm --outfile=dist/index.js --external @modelcontextprotocol/sdk --external @orpc/client --external zod","prepublishOnly":"bun run build","start":"bun run ./src/index.ts","check-types":"tsc --noEmit -p tsconfig.json"},"dependencies":{"@modelcontextprotocol/sdk":"1.26.0","@orpc/client":"^1.12.2","zod":"^4.1.13"},"devDependencies":{"@simplebug/api":"workspace:*","typescript":"^5"},"gitHead":"a0279bb4f8a7675811ead46c8d3a8e616b008ec8","_id":"@arwars/simplebug-mcp@0.1.2","bugs":{"url":"https://github.com/ArWars/SimpleBug/issues"},"homepage":"https://github.com/ArWars/SimpleBug#readme","_nodeVersion":"22.22.3","_npmVersion":"11.16.0","dist":{"integrity":"sha512-v3FNjNCJ/cBprSzQSmZNO1HEKNhkST5IaFJqaxPGIyv8ux1EpwtGGiaMlEkwVFKDTdvfcMja+uwh8dDKQP4CRA==","shasum":"c8499aa356d293ae502313c390520dc7393c4249","tarball":"https://registry.npmjs.org/@arwars/simplebug-mcp/-/simplebug-mcp-0.1.2.tgz","fileCount":3,"unpackedSize":19293,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEU1bAkWRrZ4/brC6czKRqlNjevAdD0xsJN2foRTWDptAiEAp3gF5HMwBjmQq+Ly/514RjXG4e3sO4EBpYr4N1lWqqg="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d10806f6-d4ee-488b-9b64-349410247f4d"}},"directories":{},"maintainers":[{"name":"arwars","email":"ariieelesteban@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/simplebug-mcp_0.1.2_1780568099646_0.6551879759608554"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-04T09:44:51.875Z","modified":"2026-06-04T10:14:59.908Z","0.1.0":"2026-06-04T09:20:06.025Z","0.1.1":"2026-06-04T09:44:52.282Z","0.1.2":"2026-06-04T10:14:59.817Z"},"bugs":{"url":"https://github.com/ArWars/SimpleBug/issues"},"license":"MIT","homepage":"https://github.com/ArWars/SimpleBug#readme","keywords":["mcp","model-context-protocol","simplebug","bug-reports","ai"],"repository":{"type":"git","url":"git+https://github.com/ArWars/SimpleBug.git","directory":"apps/mcp"},"description":"MCP server for SimpleBug — lets AI agents read bug reports (reproduction steps, console logs, network, video frames) to diagnose and fix bugs.","maintainers":[{"name":"arwars","email":"ariieelesteban@gmail.com"}],"readme":"# @arwars/simplebug-mcp\n\nMCP server for [SimpleBug](https://simplebug.example.com). It lets an AI agent pull\neverything captured in a bug report — reproduction steps (incl. keyboard),\nconsole logs, network requests (failures flagged), device info, and video frames\n— so it can diagnose and fix the reported bug.\n\nIt's a standard **MCP stdio server**, so it works in any MCP client: Claude Code,\nOpenClaw, Antigravity CLI, Cursor, Windsurf, etc.\n\n## Requirements\n\n- **Node.js ≥ 20**\n- **ffmpeg** / **ffprobe** on `PATH` (only needed for the video-frame tool)\n- A **SimpleBug API key** — generate your own in the SimpleBug web app under\n  **Settings → API Keys**. Keys are per-user with per-organization permissions,\n  so you only see reports for the orgs you belong to.\n\n## Configuration\n\n| Env var | Required | Default |\n| --- | --- | --- |\n| `SIMPLEBUG_API_KEY` | yes | — |\n| `SIMPLEBUG_URL` | no | `https://simplebug.example.com` |\n\n## Install\n\n### Claude Code\n\n```bash\nclaude mcp add simplebug -s user \\\n  --env SIMPLEBUG_API_KEY=sbk_your_key \\\n  --env SIMPLEBUG_URL=https://simplebug.example.com \\\n  -- npx -y @arwars/simplebug-mcp\n```\n\n### OpenClaw / Antigravity CLI / Cursor / generic MCP client\n\nAdd an MCP server entry:\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"simplebug\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@arwars/simplebug-mcp\"],\n      \"env\": {\n        \"SIMPLEBUG_API_KEY\": \"sbk_your_key\",\n        \"SIMPLEBUG_URL\": \"https://simplebug.example.com\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n- **`get_bug_report(report)`** — full report: metadata, reproduction steps\n  (incl. keyboard), console logs, network requests (failures flagged), video URL,\n  device. Accepts a share link or report id.\n- **`list_bug_reports(limit?, status?)`** — browse recent reports you can access.\n- **`get_network_request(report, request_id)`** — full headers/bodies of one\n  captured request.\n- **`get_bug_report_screenshots(report, at_seconds?)`** — extract video frames to\n  local image files and return their paths + video time + nearest reproduction\n  step, so you can inspect visual bugs with your own vision tool. Targeted by\n  default (a few orientation frames); pass `at_seconds` to zoom into a moment.\n  Never decodes the whole video.\n\n## Typical flow\n\n1. `get_bug_report` to read the steps / errors and form a hypothesis.\n2. `get_bug_report_screenshots` with `at_seconds` at the suspected moment(s);\n   look at the returned frame paths with your own vision tool and compare a few.\n3. Fix the bug.\n","readmeFilename":"README.md"}