Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Description from the maker (original English)
The bug mediator for AI-built apps: plain-English diagnosis + a ready fix, in your editor.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
MUSHI_API_KEY, MUSHI_PROJECT_ID, MUSHI_API_ENDPOINT, MUSHI_FEATURESValues marked secret are keys to your account. Never share them or paste them into a chat.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Works in Claude on the web, desktop and mobile:
https://kensaur.us/mushi-mushi/hosted-mcp/Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"mushi-mushi": {
"command": "npx",
"args": [
"-y",
"@mushi-mushi/mcp"
],
"env": {
"MUSHI_API_KEY": "your-value",
"MUSHI_PROJECT_ID": "your-value",
"MUSHI_API_ENDPOINT": "your-value",
"MUSHI_FEATURES": "your-value"
}
}
}
}Run this in your terminal
claude mcp add --transport http mushi-mushi https://kensaur.us/mushi-mushi/hosted-mcp/claude mcp add mushi-mushi --env MUSHI_API_KEY=your-value --env MUSHI_PROJECT_ID=your-value --env MUSHI_API_ENDPOINT=your-value --env MUSHI_FEATURES=your-value -- npx -y @mushi-mushi/mcpFill in the empty values before running it.
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"mushi-mushi": {
"url": "https://kensaur.us/mushi-mushi/hosted-mcp/"
}
}
}Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"mushi-mushi": {
"command": "npx",
"args": [
"-y",
"@mushi-mushi/mcp"
],
"env": {
"MUSHI_API_KEY": "your-value",
"MUSHI_PROJECT_ID": "your-value",
"MUSHI_API_ENDPOINT": "your-value",
"MUSHI_FEATURES": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"mushi-mushi": {
"type": "http",
"url": "https://kensaur.us/mushi-mushi/hosted-mcp/"
}
}
}Paste into .vscode/mcp.json in your project
{
"servers": {
"mushi-mushi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mushi-mushi/mcp"
],
"env": {
"MUSHI_API_KEY": "your-value",
"MUSHI_PROJECT_ID": "your-value",
"MUSHI_API_ENDPOINT": "your-value",
"MUSHI_FEATURES": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
ChatGPT connects only to servers on the internet:
https://kensaur.us/mushi-mushi/hosted-mcp/Menu names can differ slightly by plan and over time.
Your choice stays on this device in a cookie; no account needed.
MUSHI_PROJECT_ID envMUSHI_API_ENDPOINT envMUSHI_FEATURES envThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
The server asks you to sign in before it lists its tools.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026
The registry name was verified with the GitHub account kensaurus, which owns the repo
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
Responded in 589 ms (HTTP 401)
Declares OAuth sign-in, so your AI app can take you to log in
Not checked yet; we read the tool list when we check the endpoint
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: MUSHI_API_KEY
Either way works: install it on your computer or connect to the cloud version.
The GitHub repo last changed –, and the latest version (0.30.4) reached the registry yesterday.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
In the same category: Spec Driven Development, Remote Desktop Commander, Date Math
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Exact date/time math for agents: business days, holidays, time zones, cron, RRULE, SLA. x402 paid.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Your AI wrote it. Mushi Mushi tells you why it broke.
The Model Context Protocol server for Mushi Mushi. It lets Cursor, Claude Code, VS Code or any MCP client read your app's bug reports, get a plain-English diagnosis with a fix to start from, and dispatch or merge fixes. Your editor's own model does the work, so reading reports and fixing them in your editor needs no second AI key. Handing a fix to an agent with dispatch_fix is different: it runs the app's fix agent, which on hosted Mushi Mushi is the built-in fixer by default (no key of your own needed); Cursor's agents need your Cursor key, or run on your computer with the Mushi Mushi worker.
Docs: MCP guide · tool reference
flowchart LR
A["Bug reports in Mushi Mushi"] --> B["This MCP server"] --> C["Your editor 'what's broken in prod?'"] --> D["Fix: you, or a draft PR from an agent"]
npx mushi-mushi setup --ide cursor # or: claude, continue, zed
Restart the editor and ask *"what's broken in prod?"*. For Cursor and Claude, setup writes the hosted server entry: the editor opens a browser sign-in on first use, and no API key is stored on disk. Pass --stdio for a local server, or --with-rules to also write the lesson-library rules file. You can also use the one-click Add to Cursor button on the connect page.
{
"mcpServers": { "mushi-mushi": { "command": "npx", "args": ["-y", "@mushi-mushi/mcp@0.30.4"], "env": { "MUSHI_API_KEY": "mushi_xxxxxxxxxxxxxxxxxxxx", "MUSHI_PROJECT_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } } } }
| Variable | Where to find it |
|---|---|
MUSHI_API_KEY | Console → Connect or MCP: mint an mcp:read or mcp:write key. Not the SDK key from Setup → Verify, and not an AI key from Settings |
MUSHI_PROJECT_ID | Console → Projects → the UUID under your project's name |
MUSHI_API_ENDPOINT | Optional. Only for self-hosting, e.g. http://localhost:54321/functions/v1/api |
MUSHI_FEATURES | Optional. Tool groups to expose (see below) |
Claude Desktop does not expand ${VAR} references in this file; Cursor and VS Code expand ${env:MUSHI_API_KEY} and Claude Code expands ${MUSHI_API_KEY}. Keep the key out of any mcp.json you commit.
| Start here | What it does |
|---|---|
triage_next_steps | What needs attention right now, from the live queue |
get_fix_context | One brief for a report: root cause, repro, the smallest set of files |
triage_issue | Everything about one report: evidence, similar bugs, blast radius, logs, next actions |
dispatch_fix / merge_fix | Have an agent open a draft PR, then merge it and close the report |
diagnose_setup | Explains a broken install and the one next step |
search_mushi_docs | Answers setup and API questions from the docs |
The full catalog has 130 tools, plus 8 resources (project://dashboard, project://stats, …) and 4 prompts (summarize_report_for_fix, triage_next_steps, …). Every tool carries read-only and destructive hints, so your editor can ask before it changes anything. Full list: MCP tool reference.
Tool groups. New installs get a lean default: triage, fixes, inventory, setup, docs. Turn on more with MUSHI_FEATURES=triage,qa,codebase (stdio) or ?features=… on the hosted URL, or everything with all. Groups: qa, skills, codebase, rewards, admin, audit, usage. For a chat tool such as Lovable, or an editor that caps how many tools it loads, vibe gives about a dozen tools for the core loop. Add ?read_only=1 to the hosted URL to hide every write tool.
| Scope | Can do | Give it to |
|---|---|---|
report:write | Send reports only. No admin access | Your app's SDK. Never an MCP client |
mcp:read | Every read tool and resource | Most agent loops |
mcp:write | Reads plus dispatch_fix, merge_fix, transition_status and other changes | Agents that should act on bugs |
A key without the needed scope gets a clear INSUFFICIENT_SCOPE error, never a silent failure. Your SDK key ships in your app's bundle, so it must never carry mcp:write; the console mints MCP keys separately. Never use a Supabase service-role key. If a laptop is lost, rotate the key in the console.
~/.cursor/mcp.json only; a second copy in a project file can cause connection storms.C:/Users/...) or escaped backslashes.diagnose_setup, or run mushi doctor --mcp.| Import | Exports |
|---|---|
@mushi-mushi/mcp/server | createMushiServer() for a custom host |
@mushi-mushi/mcp/catalog | TOOL_CATALOG, scopes and tool specs |
@mushi-mushi/mcp/feature-groups | Feature-group filtering |
@mushi-mushi/mcp/clients | The supported editors and how each one installs |
@mushi-mushi/mcp/branding | Icons and server metadata |
MCP guide · MCP quickstart · The incident loop · How agent fixes work · Sample diagnosis
MIT