Log inSubmit server
Mushi Mushi logo

Mushi Mushi

by kensaurus

MCP tools for diagnosing app bug reports, generating fix prompts, and dispatching reviewable GitHub fix PRs.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Mushi Mushi

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "kensaurus-mushi-mushi": {
      "command": "npx",
      "args": [
        "-y",
        "mushi-mushi"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

kensaurus/mushi-mushi connects coding agents to Mushi Mushi's bug-report queue, where reports are diagnosed in plain English with supporting evidence and impact details. Its MCP tools let Cursor and Claude Code retrieve reports, understand likely causes, prepare fix prompts, and dispatch draft GitHub pull requests. Reach for it when user-reported bugs need to move from captured evidence to an agent-assisted fix without adding Sentry or a separate LLM key for the hosted fixer.

Use cases

  • Diagnose user-reported application bugs
  • Inspect duplicate reports and supporting evidence
  • Generate agent-ready fix prompts
  • Dispatch draft GitHub pull requests
  • Review agent fixes before merging

Key features

  • Plain-English bug diagnoses
  • Evidence and blast-radius details
  • Duplicate report grouping
  • GitHub draft PR dispatch
  • Cursor and Claude Code MCP workflow
  • Supabase-backed report queue

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

22/22 checks healthy over the last 91d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · mushi-mushi (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads1.3kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Mushi Mushi works

What kensaurus/mushi-mushi does

kensaurus/mushi-mushi exposes Mushi Mushi's bug-triage and fix-dispatch workflow through MCP. It is designed for applications that collect reports from users and need an agent to turn those reports into actionable engineering work.

Reports can include a screenshot, the affected route, the user's note, and recent console and network activity. Mushi Mushi groups duplicate reports, produces a plain-English diagnosis, and supplies evidence, an assessment of impact, and a prompt that a coding agent can use to make the change. The queue can also combine reports from application users with Sentry errors, store reviews, and Slack submissions.

The server is aimed at workflows using Cursor or Claude Code, including projects built with AI-assisted development tools such as Lovable and Bolt. It is useful when a bug does not produce a conventional exception, such as an obscured button, an action that appears unresponsive, or a slow dashboard.

How it works

A Mushi widget captures a report from the application. The system records the available client context, consolidates duplicate reports, and generates a diagnosis. An editor or agent reads that diagnosis through MCP and can use it to implement a fix.

Fixes can be dispatched as draft GitHub pull requests for human review. The hosted fixer does not require a separate key from the user, while Cursor agents use the user's Cursor credentials. Fixes can also run on the user's computer with the Mushi Mushi worker. When configured with an Anthropic key, a second AI reviews an agent pull request and recommends merging, making changes first, or holding it. A held pull request is not merged unless someone overrides the decision in the console and supplies a reason.

Setup and configuration

The command-line setup starts with:

Terminal
npx mushi-mushi

The wizard detects the framework, installs the relevant SDK, writes environment values, and sends a test report. After that, connect the editor from the Mushi connection page or run npx mushi-mushi setup --ide cursor or --ide claude. The project also provides an MCP package for editor integration and a CLI for setup, reports, fixes, and health checks.

Application SDK configuration uses a project ID and API key. Vite projects use VITE_MUSHI_PROJECT_ID and VITE_MUSHI_API_KEY; Next.js projects use the corresponding NEXT_PUBLIC_MUSHI_* variables. Framework packages are available for React, Vue, Svelte, Angular, React Native, Capacitor, and framework-independent web applications. Native iOS, Android, and Flutter SDKs are preview packages.

A hosted free plan supports one app and 100 diagnoses per month. The backend can also be self-hosted; its implementation uses Supabase edge functions and Postgres.

Tools and capabilities

  • Retrieve and inspect Mushi bug reports through MCP.
  • Read plain-English diagnoses with evidence and likely root causes.
  • Review a report's blast radius and related duplicate reports.
  • Produce paste-ready prompts for coding agents.
  • Dispatch automated GitHub fixes as draft pull requests.
  • Connect reports and fixes to an editor-based development workflow.
  • Run setup, reporting, fix, and health checks through the CLI.

Limitations and notes

The MCP workflow depends on application reports being captured through a Mushi SDK or another supported intake path. The widget and SDK require project credentials. Hosted fixing avoids a user-supplied LLM key, but Cursor agents require the user's Cursor key; optional second-AI pull-request review requires the user's own Anthropic key. Draft pull requests remain subject to human review, and the server does not automatically merge a pull request that its review marks for holding.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Mushi Mushi

kensaurus/mushi-mushi is an MCP server that connects your coding agent to Mushi Mushi's app bug-report queue. It provides tools to retrieve diagnoses, inspect evidence and blast radius, generate fix prompts, and dispatch automated GitHub fix pull requests. The workflow is intended for Cursor and Claude Code, with draft PR review before release.

Install it by running `npx mushi-mushi`, then connect your editor from the Mushi connection page or run `npx mushi-mushi setup --ide cursor` or `--ide claude`. The setup wizard detects the framework, installs the SDK, writes environment values, and sends a test report.

Yes, kensaurus/mushi-mushi supports Cursor through MCP. Connect it from the Mushi connection page or use `npx mushi-mushi setup --ide cursor`; Cursor agents use the user's Cursor key when making fixes.

Yes, kensaurus/mushi-mushi can dispatch automated fixes as draft GitHub pull requests. An agent uses the diagnosis and fix prompt to make the change, while you review the resulting draft before release.

No, Sentry is not required, and the hosted fixer does not require a separate LLM key. Cursor agents require the user's Cursor key, while optional second-AI review of agent pull requests requires the user's own Anthropic key.

Related MCP servers

All in Databases All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMushi Mushi AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/kensaurus-mushi-mushi?style=directory)](https://allmcps.com/mcp/kensaurus-mushi-mushi)
HTML Embed
<a href="https://allmcps.com/mcp/kensaurus-mushi-mushi"><img src="https://allmcps.com/api/badge/kensaurus-mushi-mushi?style=directory" alt="Mushi Mushi on AllMCPs" /></a>