@mushi-mushi/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kenji Sakuramoto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @mushi-mushi/mcp
+
+MCP (Model Context Protocol) server that exposes Mushi Mushi reports to coding agents.
+
+## Usage
+
+```bash
+MUSHI_API_KEY=key_xxx MUSHI_PROJECT_ID=proj_xxx npx @mushi-mushi/mcp
+```
+
+### Tools
+
+- `get_recent_reports` — fetch latest reports with optional filters
+- `get_report_detail` — full report with console/network logs
+- `search_reports` — keyword and semantic search
+
+### Resources
+
+- `project://settings` — current project configuration
+- `project://stats` — report counts and trends
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { createLogger } from "@mushi-mushi/core";
+var log = createLogger({ scope: "mushi:mcp", level: "info" });
+var API_ENDPOINT = process.env.MUSHI_API_ENDPOINT ?? "https://api.mushimushi.dev";
+var API_KEY = process.env.MUSHI_API_KEY ?? "";
+var PROJECT_ID = process.env.MUSHI_PROJECT_ID ?? "";
+async function apiCall(path, options) {
+  const res = await fetch(`${API_ENDPOINT}/api${path}`, {
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      "X-Mushi-Api-Key": API_KEY,
+      "X-Mushi-Project": PROJECT_ID,
+      ...options?.headers ?? {}
+    }
+  });
+  if (!res.ok) {
+    throw new Error(`Mushi API error: ${res.status} ${await res.text()}`);
+  }
+  return res.json();
+}
+var server = new McpServer({
+  name: "mushi-mushi",
+  version: "0.0.1"
+});
+server.tool(
+  "get_recent_reports",
+  "List recent bug reports with optional filters",
+  {
+    status: z.string().optional().describe("Filter by status: new, classified, grouped, fixing, fixed, dismissed"),
+    category: z.string().optional().describe("Filter by category: bug, slow, visual, confusing, other"),
+    severity: z.string().optional().describe("Filter by severity: critical, high, medium, low"),
+    limit: z.number().optional().describe("Max reports to return (default 20, max 100)")
+  },
+  async (args) => {
+    const params = new URLSearchParams();
+    if (args.status) params.set("status", args.status);
+    if (args.category) params.set("category", args.category);
+    if (args.severity) params.set("severity", args.severity);
+    params.set("limit", String(args.limit ?? 20));
+    const data = await apiCall(`/v1/admin/reports?${params}`);
+    return {
+      content: [{ type: "text", text: JSON.stringify(data.data, null, 2) }]
+    };
+  }
+);
+server.tool(
+  "get_report_detail",
+  "Get full details for a single bug report including classification, logs, and environment",
+  {
+    reportId: z.string().describe("The report UUID")
+  },
+  async (args) => {
+    const data = await apiCall(`/v1/admin/reports/${args.reportId}`);
+    return {
+      content: [{ type: "text", text: JSON.stringify(data.data, null, 2) }]
+    };
+  }
+);
+server.tool(
+  "search_reports",
+  "Search reports by keyword in description or summary",
+  {
+    query: z.string().describe("Search query text"),
+    limit: z.number().optional().describe("Max results (default 10)")
+  },
+  async (args) => {
+    const data = await apiCall(`/v1/admin/reports?limit=${args.limit ?? 10}`);
+    const q = args.query.toLowerCase();
+    const filtered = data.data.reports.filter((r) => {
+      const desc = (r.description ?? "").toLowerCase();
+      const summary = (r.summary ?? "").toLowerCase();
+      return desc.includes(q) || summary.includes(q);
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify({ results: filtered, total: filtered.length }, null, 2) }]
+    };
+  }
+);
+server.tool(
+  "get_fix_context",
+  "Get all context an agent needs to fix a bug: report, classification, repro steps, relevant code, graph context",
+  {
+    reportId: z.string().describe("The report UUID to fix")
+  },
+  async (args) => {
+    const report = await apiCall(`/v1/admin/reports/${args.reportId}`);
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          report: report.data,
+          reproductionSteps: report.data.reproduction_steps ?? [],
+          component: report.data.component,
+          rootCause: report.data.stage2_analysis?.rootCause,
+          bugOntologyTags: report.data.bug_ontology_tags
+        }, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "submit_fix_result",
+  "Agent reports fix outcome \u2014 branch, PR URL, files changed",
+  {
+    reportId: z.string().describe("The report UUID"),
+    branch: z.string().describe("Git branch name"),
+    prUrl: z.string().optional().describe("GitHub PR URL"),
+    filesChanged: z.array(z.string()).describe("Files modified"),
+    linesChanged: z.number().describe("Total lines changed"),
+    summary: z.string().describe("Fix summary")
+  },
+  async (args) => {
+    const data = await apiCall("/v1/admin/fixes", {
+      method: "POST",
+      body: JSON.stringify({ reportId: args.reportId, agent: "mcp" })
+    });
+    await apiCall(`/v1/admin/fixes/${data.data.fixId}`, {
+      method: "PATCH",
+      body: JSON.stringify({
+        status: "completed",
+        branch: args.branch,
+        pr_url: args.prUrl,
+        files_changed: args.filesChanged,
+        lines_changed: args.linesChanged,
+        summary: args.summary,
+        completed_at: (/* @__PURE__ */ new Date()).toISOString()
+      })
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify({ ok: true, fixId: data.data.fixId }) }]
+    };
+  }
+);
+server.tool(
+  "get_similar_bugs",
+  "Find related bugs via knowledge graph or keyword search",
+  {
+    query: z.string().describe("Component name, page, or bug description"),
+    limit: z.number().optional().describe("Max results (default 5)")
+  },
+  async (args) => {
+    const data = await apiCall(`/v1/admin/reports?limit=${args.limit ?? 5}`);
+    const q = args.query.toLowerCase();
+    const similar = data.data.reports.filter((r) => {
+      const text = `${r.summary ?? ""} ${r.component ?? ""} ${r.description ?? ""}`.toLowerCase();
+      return text.includes(q);
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify({ similar, total: similar.length }, null, 2) }]
+    };
+  }
+);
+server.tool(
+  "get_blast_radius",
+  "Graph traversal showing affected areas for a given bug group",
+  {
+    nodeId: z.string().describe("Graph node UUID")
+  },
+  async (args) => {
+    const data = await apiCall(`/v1/admin/graph/blast-radius/${args.nodeId}`);
+    return {
+      content: [{ type: "text", text: JSON.stringify(data.data, null, 2) }]
+    };
+  }
+);
+server.resource(
+  "project_stats",
+  "project://stats",
+  { description: "Report counts, category breakdown, severity distribution" },
+  async () => {
+    const data = await apiCall("/v1/admin/stats");
+    return {
+      contents: [{ uri: "project://stats", mimeType: "application/json", text: JSON.stringify(data.data, null, 2) }]
+    };
+  }
+);
+async function main() {
+  if (!API_KEY) {
+    log.fatal("MUSHI_API_KEY environment variable is required");
+    process.exit(1);
+  }
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((err) => {
+  log.fatal("MCP server crashed", { err: String(err) });
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@mushi-mushi/mcp",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "MCP server exposing Mushi Mushi reports to coding agents",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mushi-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "test": "echo 'no tests yet'",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@mushi-mushi/core": "workspace:*",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@mushi-mushi/eslint-config": "workspace:*",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.39.4",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kensaurus/mushi-mushi.git",
+    "directory": "packages/mcp"
+  },
+  "author": "Kenji Sakuramoto",
+  "homepage": "https://github.com/kensaurus/mushi-mushi/tree/main/packages/mcp#readme",
+  "bugs": {
+    "url": "https://github.com/kensaurus/mushi-mushi/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "mushi-mushi",
+    "bug-reporting",
+    "sdk"
+  ]
+}