@rui.branco/sentry-mcp 1.0.1 → 1.0.3

package/index.js

@@ -3,7 +3,7 @@
 // Handle setup command
 if (process.argv[2] === "setup") {
   require("./setup.js");
-  return;
+  process.exit(0);
 }
 
 const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
@@ -156,7 +156,26 @@ async function fetchSentry(apiPath, instance, options = {}) {
 
 // ── Helpers ─────────────────────────────────────────────────────────────────
 
-function formatIssue(issue) {
+// Strip noisy/internal fields that waste context but keep everything useful
+function cleanIssueData(issue) {
+  const skip = new Set(["pluginActions", "pluginContexts", "pluginIssues", "activity", "seenBy", "stats"]);
+  const cleaned = {};
+  for (const [k, v] of Object.entries(issue)) {
+    if (!skip.has(k) && v != null && v !== "") cleaned[k] = v;
+  }
+  return cleaned;
+}
+
+function cleanEventData(event) {
+  const skip = new Set(["_meta", "groupID", "eventID", "sdk", "dist", "fingerprints"]);
+  const cleaned = {};
+  for (const [k, v] of Object.entries(event)) {
+    if (!skip.has(k) && v != null && v !== "") cleaned[k] = v;
+  }
+  return cleaned;
+}
+
+function formatIssueSummary(issue) {
   const meta = issue.metadata || {};
   const lines = [];
   lines.push(`**${issue.title}**`);
@@ -175,98 +194,6 @@ function formatIssue(issue) {
   return lines.join("\n");
 }
 
-function formatEvent(event) {
-  const lines = [];
-
-  // Stack traces
-  const exceptions =
-    event.entries?.find((e) => e.type === "exception")?.data?.values || [];
-  if (exceptions.length) {
-    lines.push("## Stack Trace\n");
-    for (const ex of exceptions) {
-      if (ex.type || ex.value) lines.push(`**${ex.type || "Exception"}:** ${ex.value || ""}\n`);
-      const frames = ex.stacktrace?.frames;
-      if (frames?.length) {
-        lines.push("```");
-        for (const f of frames) {
-          const loc = f.lineNo ? `:${f.lineNo}${f.colNo ? ":" + f.colNo : ""}` : "";
-          const marker = f.inApp ? "-> " : "   ";
-          lines.push(`${marker}${f.function || "?"} (${f.filename || "?"}${loc})`);
-        }
-        lines.push("```\n");
-      }
-    }
-  }
-
-  // Breadcrumbs
-  const breadcrumbs =
-    event.entries?.find((e) => e.type === "breadcrumbs")?.data?.values || [];
-  if (breadcrumbs.length) {
-    const last = breadcrumbs.slice(-20);
-    lines.push(`## Breadcrumbs (last ${last.length})\n`);
-    for (const bc of last) {
-      const msg = bc.message || bc.data?.url || bc.data?.to || "";
-      lines.push(`- **${bc.category || "?"}** [${bc.level || "info"}] ${msg}`);
-    }
-    lines.push("");
-  }
-
-  // HTTP Request
-  const httpReq =
-    event.entries?.find((e) => e.type === "request")?.data;
-  if (httpReq) {
-    lines.push("## HTTP Request\n");
-    lines.push(`\`${httpReq.method || "GET"} ${httpReq.url || ""}\``);
-    if (httpReq.headers) {
-      lines.push("\n```");
-      for (const [k, v] of httpReq.headers) {
-        lines.push(`${k}: ${v}`);
-      }
-      lines.push("```");
-    }
-    lines.push("");
-  }
-
-  // Tags
-  if (event.tags?.length) {
-    lines.push("## Tags\n");
-    lines.push("| Key | Value |");
-    lines.push("|-----|-------|");
-    for (const t of event.tags) {
-      lines.push(`| ${t.key} | ${t.value} |`);
-    }
-    lines.push("");
-  }
-
-  // Contexts
-  if (event.contexts) {
-    lines.push("## Contexts\n");
-    for (const [name, ctx] of Object.entries(event.contexts)) {
-      if (name === "trace" || name === "replay" || !ctx || typeof ctx !== "object") continue;
-      const entries = Object.entries(ctx).filter(([k, v]) => k !== "type" && v != null && v !== "");
-      if (!entries.length) continue;
-      const title = name.charAt(0).toUpperCase() + name.slice(1).replace(/_/g, " ");
-      lines.push(`**${title}:**`);
-      for (const [k, v] of entries.slice(0, 15)) {
-        const display = typeof v === "object" ? JSON.stringify(v) : String(v);
-        lines.push(`- ${k}: ${display}`);
-      }
-      lines.push("");
-    }
-  }
-
-  // User
-  if (event.user) {
-    const u = event.user;
-    lines.push("## User\n");
-    lines.push(`${u.username || u.name || u.email || u.id || "unknown"}${u.email ? " (" + u.email + ")" : ""}`);
-    if (u.ip_address) lines.push(`IP: ${u.ip_address}`);
-    lines.push("");
-  }
-
-  return lines.join("\n") || "No event data available.";
-}
-
 // ── MCP Server ──────────────────────────────────────────────────────────────
 
 const server = new Server(
@@ -456,6 +383,232 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["issueId", "assignee"],
         },
       },
+      {
+        name: "sentry_list_releases",
+        description:
+          "List releases for a Sentry project. Returns release versions, dates, and artifact counts.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description:
+                "Optional search query to filter releases by version (e.g. '26.05').",
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: [],
+        },
+      },
+      {
+        name: "sentry_get_release_artifacts",
+        description:
+          "List artifacts (source maps, JS bundles) uploaded for a specific release. Use to verify source maps were uploaded correctly.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string (e.g. '26.05.4b185-TRAIN').",
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_create_release",
+        description:
+          "Create a new release in Sentry. Optionally associate commits and set a ref.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string (e.g. '1.0.0', '26.05.4b185-TRAIN').",
+            },
+            ref: {
+              type: "string",
+              description: "Optional git ref (commit SHA or tag).",
+            },
+            projects: {
+              type: "array",
+              items: { type: "string" },
+              description: "Project slugs to associate with this release. Defaults to the instance's projectSlug.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_finalize_release",
+        description:
+          "Finalize a release (mark it as deployed/complete). Sets dateReleased to now.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_delete_release",
+        description:
+          "Delete a release and all its artifacts from Sentry.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string to delete.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_create_deploy",
+        description:
+          "Create a deploy for a release. Records when and where a release was deployed.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            environment: {
+              type: "string",
+              description: "Environment name (e.g. 'production', 'staging', 'QA', 'TRAIN').",
+            },
+            name: {
+              type: "string",
+              description: "Optional deploy name.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version", "environment"],
+        },
+      },
+      {
+        name: "sentry_list_deploys",
+        description:
+          "List deploys for a release.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_delete_artifact",
+        description:
+          "Delete a specific artifact from a release by its ID.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            artifactId: {
+              type: "string",
+              description: "Artifact ID to delete (from sentry_get_release_artifacts).",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version", "artifactId"],
+        },
+      },
+      {
+        name: "sentry_set_commits",
+        description:
+          "Associate commits with a release. Provide a repository and commit range.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            repository: {
+              type: "string",
+              description: "Repository name (e.g. 'org/repo').",
+            },
+            commit: {
+              type: "string",
+              description: "Current commit SHA (HEAD of the release).",
+            },
+            previousCommit: {
+              type: "string",
+              description: "Previous commit SHA (start of range). If omitted, uses the previous release's commit.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version", "repository", "commit"],
+        },
+      },
+      {
+        name: "sentry_get_release",
+        description:
+          "Get full details for a specific release including projects, commits, authors, and deploy info.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
       {
         name: "sentry_list_instances",
         description:
@@ -573,7 +726,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           content: [{ type: "text", text: `No issues found for query: ${query}` }],
         };
       }
-      const formatted = data.map(formatIssue);
+      const formatted = data.map(formatIssueSummary);
       return {
         content: [
           {
@@ -591,7 +744,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         inst,
       );
       return {
-        content: [{ type: "text", text: formatIssue(data) }],
+        content: [{ type: "text", text: JSON.stringify(cleanIssueData(data), null, 2) }],
       };
 
     } else if (name === "sentry_get_latest_event") {
@@ -602,7 +755,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         inst,
       );
       return {
-        content: [{ type: "text", text: formatEvent(data) }],
+        content: [{ type: "text", text: JSON.stringify(cleanEventData(data), null, 2) }],
       };
 
     } else if (name === "sentry_resolve_issue") {
@@ -659,7 +812,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           content: [{ type: "text", text: `No issues found for query: ${args.query}` }],
         };
       }
-      const formatted = data.map(formatIssue);
+      const formatted = data.map(formatIssueSummary);
       return {
         content: [
           {
@@ -683,6 +836,183 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         ],
       };
 
+    } else if (name === "sentry_list_releases") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      if (!inst.projectSlug) throw new Error("No projectSlug configured for this instance.");
+      const params = new URLSearchParams();
+      if (args.query) params.set("query", args.query);
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/?project=${encodeURIComponent(inst.projectSlug)}&${params}`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No releases found.${args.query ? ` Query: ${args.query}` : ""}` }],
+        };
+      }
+      const lines = data.slice(0, 25).map((r) => {
+        const artifacts = r.newGroups != null ? ` | New issues: ${r.newGroups}` : "";
+        return `- **${r.version}** | Created: ${r.dateCreated || "N/A"}${artifacts}${r.lastEvent ? ` | Last event: ${r.lastEvent}` : ""}`;
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Found ${data.length} release(s):\n\n${lines.join("\n")}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_get_release_artifacts") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/files/`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No artifacts found for release "${args.version}". Source maps may not have been uploaded.` }],
+        };
+      }
+      const lines = data.map((a) => {
+        const size = a.size ? ` (${(a.size / 1024).toFixed(1)} KB)` : "";
+        return `- ${a.name}${size} [id: ${a.id}]`;
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Found ${data.length} artifact(s) for release "${args.version}":\n\n${lines.join("\n")}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_create_release") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const projects = args.projects || (inst.projectSlug ? [inst.projectSlug] : []);
+      if (!projects.length) throw new Error("No projects specified and no projectSlug configured.");
+      const body = { version: args.version, projects };
+      if (args.ref) body.ref = args.ref;
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/`,
+        inst,
+        { method: "POST", body },
+      );
+      return {
+        content: [{ type: "text", text: `Release "${data.version}" created for projects: ${projects.join(", ")}` }],
+      };
+
+    } else if (name === "sentry_finalize_release") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/`,
+        inst,
+        { method: "PUT", body: { dateReleased: new Date().toISOString() } },
+      );
+      return {
+        content: [{ type: "text", text: `Release "${args.version}" finalized.` }],
+      };
+
+    } else if (name === "sentry_delete_release") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/`,
+        inst,
+        { method: "DELETE" },
+      );
+      return {
+        content: [{ type: "text", text: `Release "${args.version}" deleted.` }],
+      };
+
+    } else if (name === "sentry_create_deploy") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const body = { environment: args.environment };
+      if (args.name) body.name = args.name;
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/deploys/`,
+        inst,
+        { method: "POST", body },
+      );
+      return {
+        content: [{ type: "text", text: `Deploy created for release "${args.version}" to environment "${args.environment}".` }],
+      };
+
+    } else if (name === "sentry_list_deploys") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/deploys/`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No deploys found for release "${args.version}".` }],
+        };
+      }
+      const lines = data.map((d) => `- **${d.environment}** | ${d.dateFinished || d.dateStarted || "N/A"}${d.name ? ` | ${d.name}` : ""}`);
+      return {
+        content: [{ type: "text", text: `${data.length} deploy(s) for "${args.version}":\n\n${lines.join("\n")}` }],
+      };
+
+    } else if (name === "sentry_delete_artifact") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/files/${encodeURIComponent(args.artifactId)}/`,
+        inst,
+        { method: "DELETE" },
+      );
+      return {
+        content: [{ type: "text", text: `Artifact ${args.artifactId} deleted from release "${args.version}".` }],
+      };
+
+    } else if (name === "sentry_set_commits") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const commitSpec = { repository: args.repository, currentId: args.commit };
+      if (args.previousCommit) commitSpec.previousId = args.previousCommit;
+      await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/commits/`,
+        inst,
+        { method: "PUT", body: { commits: [commitSpec] } },
+      );
+      return {
+        content: [{ type: "text", text: `Commits associated with release "${args.version}" (repo: ${args.repository}, HEAD: ${args.commit}).` }],
+      };
+
+    } else if (name === "sentry_get_release") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/`,
+        inst,
+      );
+      const lines = [];
+      lines.push(`**${data.version}**`);
+      lines.push(`- Status: ${data.status || "open"}`);
+      lines.push(`- Created: ${data.dateCreated || "N/A"}`);
+      if (data.dateReleased) lines.push(`- Released: ${data.dateReleased}`);
+      if (data.firstEvent) lines.push(`- First event: ${data.firstEvent}`);
+      if (data.lastEvent) lines.push(`- Last event: ${data.lastEvent}`);
+      lines.push(`- New issues: ${data.newGroups || 0}`);
+      lines.push(`- Commits: ${data.commitCount || 0}`);
+      lines.push(`- Deploys: ${data.deployCount || 0}`);
+      if (data.projects?.length) {
+        lines.push(`- Projects: ${data.projects.map((p) => p.slug || p.name).join(", ")}`);
+      }
+      if (data.authors?.length) {
+        lines.push(`- Authors: ${data.authors.map((a) => a.name || a.email).join(", ")}`);
+      }
+      return {
+        content: [{ type: "text", text: lines.join("\n") }],
+      };
+
     } else if (name === "sentry_list_instances") {
       if (!instances.length) {
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rui.branco/sentry-mcp",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Sentry MCP server for Claude Code - fetch issues, search errors, resolve/ignore issues, get stack traces and breadcrumbs",
   "main": "index.js",
   "bin": {
@@ -12,7 +12,8 @@
     "README.md"
   ],
   "scripts": {
-    "setup": "node setup.js"
+    "setup": "node setup.js",
+    "test": "vitest run"
   },
   "keywords": [
     "mcp",
@@ -27,5 +28,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.3",
     "node-fetch": "^2.7.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.6"
   }
 }