mushi-mushi

@mushi-mushi/mcp

AI が書いたコードが壊れた理由を、Mushi が教えてくれます。

Mushi Mushi の Model Context Protocol サーバーです。Cursor、Claude Code、VS Code、その他の MCP クライアントでアプリのバグレポートを読み取り、平易な言葉で修正の手がかりとなる診断を取得し、修正を依頼またはマージできます。作業にはエディター自身のモデルを使うため、別の LLM キーは必要ありません。

ドキュメント：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	Console → Connect または MCP：mcp:read または mcp:write キーを発行します。Setup → Verify の SDK キーでも、Settings の AI キーでもありません
MUSHI_PROJECT_ID	Console → 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	1 件のレポートに関するすべての情報：証拠、類似バグ、影響範囲、ログ、次のアクション
dispatch_fix / merge_fix	エージェントにドラフト 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	すべての読み取りツールとリソース	ほとんどのエージェントループ
mcp:write	読み取りに加え、dispatch_fix、merge_fix、transition_status などの変更	バグに対処するエージェント

必要なスコープがないキーを使うと、明確な INSUFFICIENT_SCOPE エラーが返され、何も通知されないまま失敗することはありません。SDK キーはアプリのバンドルに含まれるため、mcp:write を絶対に付与しないでください。コンソールでは MCP キーを別途発行します。Supabase のサービスロールキーは絶対に使用しないでください。ノート PC を紛失した場合は、コンソールでキーをローテーションしてください。

トラブルシューティング

• ツールが何も表示されませんか？ MCP パネルに緑の点が表示されていることを確認し、設定を変更した後はエディターを完全に再起動してください。
• 設定は1つにまとめてください。 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