@rui.branco/sentry-mcp 1.0.2 → 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");
@@ -383,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:
@@ -610,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.2",
+  "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"
   }
 }