mushi-mushi

@mushi-mushi/mcp

你的 AI 写了代码。Mushi 告诉你代码为什么出错。

Mushi Mushi 的 Model Context Protocol 服务。它让 Cursor、Claude Code、VS Code 或任何 MCP 客户端读取应用的错误报告，获取通俗易懂的诊断和可供参考的修复方案，并分派或合并修复。由编辑器自身的模型完成工作，因此无需额外的大模型密钥。

文档：MCP 指南 · 工具参考

flowchart LR
    A["Bug reports<br/>in Mushi"] --> B["This MCP server"] --> C["Your editor<br/>'what's broken in prod?'"] --> D["Fix: you, or a<br/>draft PR from an agent"]

快速开始

npx mushi-mushi setup --ide cursor   # or: claude, continue, zed

重启编辑器并询问 “生产环境中有什么问题？”。对于 Cursor 和 Claude，setup 会写入托管服务条目：首次使用时，编辑器会打开浏览器进行登录，无需在磁盘上存储 API 密钥。添加 --stdio 可启动本地服务，添加 --with-rules 还会写入课程库规则文件。你也可以使用连接页面上的一键式 添加到 Cursor 按钮。

手动设置（任何 MCP 客户端）

{
  "mcpServers": {
    "mushi-mushi": {
      "command": "npx",
      "args": ["-y", "@mushi-mushi/[email protected]"],
      "env": {
        "MUSHI_API_KEY": "mushi_xxxxxxxxxxxxxxxxxxxx",
        "MUSHI_PROJECT_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

变量	查找位置
MUSHI_API_KEY	控制台 → Connect 或 MCP：创建一个 mcp:read 或 mcp:write 密钥。不要使用 Setup → Verify 中的 SDK 密钥，也不要使用 Settings 中的 AI 密钥
MUSHI_PROJECT_ID	控制台 → Projects → 项目名称下方的 UUID
MUSHI_API_ENDPOINT	可选。仅用于自托管，例如 http://localhost:54321/functions/v1/api
MUSHI_FEATURES	可选。要开放的工具组（见下文）

Claude Desktop 不会展开此文件中的 ${VAR} 引用；Cursor 和 VS Code 会展开 ${env:MUSHI_API_KEY}，Claude Code 会展开 ${MUSHI_API_KEY}。请勿将密钥写入并提交到任何 mcp.json 中。

编辑器可获取的内容

从这里开始	功能
triage_next_steps	根据实时队列，查看当前需要处理的事项
get_fix_context	获取某个报告的简要说明：根本原因、复现方法和最少文件集
triage_issue	查看某个报告的所有信息：证据、相似错误、影响范围、日志和后续操作
dispatch_fix / merge_fix	让 Agent 创建一个草稿 PR，然后合并该 PR 并关闭报告
diagnose_setup	说明安装故障及下一步操作
search_mushi_docs	根据文档解答设置和 API 问题

完整目录包含 129 个工具、8 个资源（project://dashboard、project://stats、……）和 4 个提示词（summarize_report_for_fix、triage_next_steps、……）。每个工具都附带只读和破坏性操作提示，因此编辑器可以在更改任何内容前询问。完整列表：MCP 工具参考。

工具组。 新安装默认启用精简配置：triage、fixes、inventory、setup、docs。使用 MUSHI_FEATURES=triage,qa,codebase（stdio）或在托管 URL 中添加 ?features=… 可启用更多工具组；使用 all 可启用全部工具组。工具组：qa、skills、codebase、rewards、admin、audit、usage。在托管 URL 中添加 ?read_only=1 可隐藏所有写入工具。

密钥与安全

范围	可执行操作	提供给
report:write	仅发送报告。无管理员访问权限	你的应用的 SDK。切勿提供给 MCP 客户端
mcp:read	所有读取工具和资源	大多数 Agent 循环
mcp:write	读取，以及 dispatch_fix、merge_fix、transition_status 和其他更改操作	应当处理 bug 的 Agent

缺少所需范围的密钥会明确报错 INSUFFICIENT_SCOPE，绝不会静默失败。你的 SDK 密钥会随应用一起打包，因此绝不能包含 mcp:write；控制台会单独签发 MCP 密钥。切勿使用 Supabase 服务角色密钥。如果笔记本电脑丢失，请在控制台轮换密钥。

故障排除

• 没有显示工具？ 检查 MCP 面板中是否有绿色圆点，然后在更改任何配置后彻底重启编辑器。
• 只保留一份配置。 仅将 Mushi 条目放在全局 ~/.cursor/mcp.json 中；项目文件中的副本可能导致连接风暴。
• Windows 路径在 JSON 中需要使用正斜杠（C:/Users/...）或转义反斜杠。
• 还是无法解决？ 请编辑器运行 diagnose_setup，或运行 mushi doctor --mcp。

编程方式使用

导入	导出内容
@mushi-mushi/mcp/server	用于自定义主机的 createMushiServer()
@mushi-mushi/mcp/catalog	TOOL_CATALOG、范围和工具规范
@mushi-mushi/mcp/feature-groups	按功能组筛选
@mushi-mushi/mcp/clients	支持的编辑器及各自的安装方式
@mushi-mushi/mcp/branding	图标和服务元数据

了解更多

MCP 指南 · MCP 快速入门 · 事件处理循环 · 修复协调器

许可证

MIT