BugEzy

Official13 tools

by fox100039-design · TypeScript

Voice-powered bug reporting with 13 MCP tools. Record bugs by talking; let AI find and fix them.

Captured live from the server via tools/list.

list_reports

列出某使用者的 Bug 報告（需提供 user_email + session_token 驗證身分）。List a user's bug reports — requires user_email and session_token.

Parameters4

user_email	string	optional	使用者 email；只回傳該 email 的報告。未提供則不回任何報告（安全預設）。
session_token	string	optional	BugEzy session token（如果 MCP URL 已帶 ?token= 則不需提供）。
limit	number	optional
url	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "user_email": {
      "description": "使用者 email；只回傳該 email 的報告。未提供則不回任何報告（安全預設）。",
      "type": "string"
    },
    "session_token": {
      "description": "BugEzy session token（如果 MCP URL 已帶 ?token= 則不需提供）。",
      "type": "string"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50
    },
    "url": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_report_overview

取得報告概覽（metadata + 各筆數 + AI Bug 導航摘要，不含原始資料）。Report overview with AI bug summary.

Parameters1

report_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string"
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_console_logs

取得 Console 記錄（warn/error）。Console logs.

Parameters1

report_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string"
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_network_errors

取得 Network 錯誤（4xx/5xx）。Network errors.

Parameters1

report_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string"
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_voice_transcript

取得開發者語音描述（中文轉錄）。Developer voice transcript.

Parameters1

report_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string"
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_page_info

取得頁面資訊（URL/標題/瀏覽器/解析度）。Page info.

Parameters1

report_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string"
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_rrweb_summary

DOM 軌跡摘要（事件數/時長/類型分布，不回完整資料）。rrweb summary.

Parameters1

report_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string"
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_rrweb_events

取得完整 DOM 事件（⚠ 資料量大）。Full rrweb events.

Parameters1

report_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string"
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_live_errors

取得某使用者當前頁面的即時 Console/Network 錯誤（需 user_email + session_token 驗證身分）。Live console/network errors — requires user_email and session_token.

Parameters2

user_email	string	required	你的 BugEzy email（只讀你自己的即時錯誤）
session_token	string	optional	BugEzy session token（如果 MCP URL 已帶 ?token= 則不需提供）。

Raw schema

{
  "type": "object",
  "properties": {
    "user_email": {
      "type": "string",
      "description": "你的 BugEzy email（只讀你自己的即時錯誤）"
    },
    "session_token": {
      "description": "BugEzy session token（如果 MCP URL 已帶 ?token= 則不需提供）。",
      "type": "string"
    }
  },
  "required": [
    "user_email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_terminal_logs

取得某使用者終端機的即時錯誤日誌（stderr/throw/crash，需 user_email + session_token 驗證；付費功能）。開發者需執行 npx bugezy-watch -- <command>。Terminal error logs — requires user_email and session_token, paid feature.

Parameters2

user_email	string	required	你的 BugEzy email（只讀你自己的終端機日誌）
session_token	string	optional	BugEzy session token（如果 MCP URL 已帶 ?token= 則不需提供）。

Raw schema

{
  "type": "object",
  "properties": {
    "user_email": {
      "type": "string",
      "description": "你的 BugEzy email（只讀你自己的終端機日誌）"
    },
    "session_token": {
      "description": "BugEzy session token（如果 MCP URL 已帶 ?token= 則不需提供）。",
      "type": "string"
    }
  },
  "required": [
    "user_email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_usage_stats

取得當月的 MCP 使用量統計（呼叫次數、token 消耗、省了多少）。Monthly MCP usage stats.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_screenshots

高畫質 AI 分析：取得報告截圖圖片（視覺 Bug 用）。⚠ 圖片消耗較高 Token（每張 ~3,000-8,000），建議只在需要看畫面時使用。Report screenshots.

Parameters2

report_id	string	required
include_images	boolean	optional	開啟高畫質 AI 分析（預設 false，只回 metadata 省 Token）

Raw schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string"
    },
    "include_images": {
      "description": "開啟高畫質 AI 分析（預設 false，只回 metadata 省 Token）",
      "type": "boolean"
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_timeline

取得一份報告的完整時間軸（時序麵包屑）。把 Console、Network、語音、標記、網路環境、儲存狀態全部按時間排序成一條故事線，AI 只需呼叫這一個 tool 就能掌握完整 Bug 脈絡（省去逐一呼叫 console/network/voice 各 tool）。Full report timeline.

Parameters1

report_id

string

required

報告 ID

Raw schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string",
      "description": "報告 ID"
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md4 KBView on GitHub

🐛 BugEzy — Voice-Powered Bug Reporting for Developers

Capture bugs by talking. Let AI fix them.

BugEzy is a Chrome extension + MCP server that lets developers report bugs using voice. It captures console logs, network errors, DOM traces, and your voice description automatically — so AI can find the root cause and give you the fix.

🌐 bugezy.dev · 🧩 Chrome Web Store · 📖 SKILL.md (AI Guide)

How It Works

🎙️ Hit Record — Open BugEzy popup, hit record. Talk about the bug while operating.
📋 Auto-organized — BugEzy captures screen replay, console logs, network errors, and action timeline into a structured report.
🤖 AI Fixes It — Hand the report to any MCP-compatible AI assistant. AI finds root causes and gives you the fix.

MCP Server (13 Tools)

Connect your AI assistant to BugEzy:

MCP Endpoint: https://bugezy.dev/mcp (Streamable HTTP)

Tool	Description
`get_report_overview`	Report metadata + AI bug navigation summary
`get_timeline`	Complete event timeline (console + network + voice + markers)
`get_console_logs`	Console logs (warn/error)
`get_network_errors`	Network errors (4xx/5xx)
`get_voice_transcript`	Developer voice transcript
`get_screenshots`	Report screenshots
`get_rrweb_summary`	DOM trace summary
`get_rrweb_events`	Full DOM events
`get_page_info`	Page info (URL/title/browser/resolution)
`get_metadata`	Custom metadata via SDK
`list_reports`	List user's bug reports
`get_live_errors`	Live console/network errors
`get_terminal_logs`	Terminal error logs

MCP Config (Claude Desktop / Cursor / Windsurf)

json

{
  "mcpServers": {
    "bugezy": {
      "url": "https://bugezy.dev/mcp"
    }
  }
}

Features

Voice Input — Chinese, Cantonese, English (Japanese, Korean, Vietnamese coming soon)
Dual Voice Engine — Web Speech API (free) + Groq Whisper (paid, high accuracy)
6 Recording Modes — Record, Rewind 30s, Screenshot, Keyboard, Monitor, CLI
Bug Capture 10/10 — Console, Network, Resource errors, Web Vitals, DOM replay, Storage, Voice, Screenshots
Privacy First — Sensitive data auto-masked (PII, JWT, API keys, credit cards)
AI Auto-correction — Voice transcript cleanup + summarization
Save 93% Tokens — Structured MCP data vs raw screenshots

Python / Node CLI

bash

npm install -g bugezy-watch

Captures Python tracebacks, Node.js errors, environment snapshots, and PII-masked terminal logs.

Pricing

Plan	Price	Includes
Free	$0	10 recordings, 5 rewinds, 20 MCP calls/month
Monthly	NT$80/mo (~$2.50)	Unlimited everything
Day Pass	NT$20 (~$0.65)	24-hour full access

Security

Fable5 4-round audit: 9.5+/10
Supabase RLS on all 6 tables
CSP with frame-ancestors
Session token fragment-based (never in URL query string)
ECPay payment with idempotent callback

Tech Stack

Chrome Extension (TypeScript) · Cloudflare Workers · Supabase · R2 · Groq Whisper · ECPay

License

Install

Tools (13)

list_reportsget_report_overviewget_console_logsget_network_errorsget_voice_transcriptget_page_infoget_rrweb_summaryget_rrweb_events

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://bugezy.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "bugezy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bugezy.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

list_reports

get_report_overview

get_console_logs

get_network_errors

get_voice_transcript

get_page_info

get_rrweb_summary

get_rrweb_events

get_live_errors

get_terminal_logs

get_usage_stats

get_screenshots

get_timeline

🐛 BugEzy — Voice-Powered Bug Reporting for Developers

How It Works

MCP Server (13 Tools)

MCP Config (Claude Desktop / Cursor / Windsurf)

Features

Python / Node CLI

Pricing

Security

Tech Stack

Links

License

Install

Remote endpoint