@rui.branco/sentry-mcp 1.0.6 → 1.0.8

package/package.json

@@ -1,35 +1,37 @@
-{
-  "name": "@rui.branco/sentry-mcp",
-  "version": "1.0.6",
-  "description": "Sentry MCP server for any MCP-compatible AI client (Claude Code, Codex, Antigravity, Cursor, etc.) - fetch issues, search errors, resolve/ignore issues, get stack traces and breadcrumbs",
-  "main": "index.js",
-  "bin": {
-    "sentry-mcp": "./index.js"
-  },
-  "files": [
-    "index.js",
-    "setup.js",
-    "README.md"
-  ],
-  "scripts": {
-    "setup": "node setup.js",
-    "test": "vitest run"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "sentry",
-    "claude",
-    "claude-code",
-    "error-tracking"
-  ],
-  "author": "Rui Branco",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.3",
-    "node-fetch": "^2.7.0"
-  },
-  "devDependencies": {
-    "vitest": "^4.1.6"
-  }
-}
+{
+  "name": "@rui.branco/sentry-mcp",
+  "version": "1.0.8",
+  "description": "Sentry MCP server for any MCP-compatible AI client (Claude Code, Codex, Antigravity, Cursor, etc.) - fetch issues, search errors, resolve/ignore issues, get stack traces and breadcrumbs",
+  "main": "index.js",
+  "bin": {
+    "sentry-mcp": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "setup.js",
+    "icons.js",
+    "assets/icon.svg",
+    "README.md"
+  ],
+  "scripts": {
+    "setup": "node setup.js",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "sentry",
+    "claude",
+    "claude-code",
+    "error-tracking"
+  ],
+  "author": "Rui Branco",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "node-fetch": "^2.7.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.6"
+  }
+}

package/setup.js

@@ -1,266 +1,267 @@
-#!/usr/bin/env node
-
-const readline = require("readline");
-const fs = require("fs");
-const path = require("path");
-
-const configDir = path.join(process.env.HOME, ".config/sentry-mcp");
-const configPath = path.join(configDir, "config.json");
-
-// Check for command line arguments
-let args = process.argv.slice(2);
-// Skip "setup" arg if called via index.js
-if (args[0] === "setup") args = args.slice(1);
-
-// Load existing config if present
-function loadConfig() {
-  try {
-    if (fs.existsSync(configPath)) {
-      return JSON.parse(fs.readFileSync(configPath, "utf8"));
-    }
-  } catch {}
-  return null;
-}
-
-function saveConfig(config) {
-  if (!fs.existsSync(configDir)) {
-    fs.mkdirSync(configDir, { recursive: true });
-  }
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-}
-
-// Non-interactive: setup add <name> <token> <baseUrl> <orgSlug> [projectSlug] [projects...]
-if (args[0] === "add" && args.length >= 4) {
-  const [, name, token, baseUrl, orgSlug, projectSlug, ...projectArgs] = args;
-  const projects = projectArgs.length > 0
-    ? projectArgs.join(",").split(",").map((p) => p.trim().toLowerCase()).filter(Boolean)
-    : [];
-
-  const config = loadConfig() || {};
-
-  // Migrate old format if needed
-  if (config.token && !config.instances) {
-    config.instances = [{
-      name: "default",
-      token: config.token,
-      baseUrl: config.baseUrl,
-      orgSlug: config.orgSlug,
-      projectSlug: config.projectSlug || "",
-      projects: [],
-    }];
-    config.defaultInstance = "default";
-    delete config.token;
-    delete config.baseUrl;
-    delete config.orgSlug;
-    delete config.projectSlug;
-  }
-
-  if (!config.instances) config.instances = [];
-
-  // Replace or add instance
-  const existing = config.instances.findIndex((i) => i.name === name);
-  const instance = {
-    name,
-    token,
-    baseUrl: baseUrl.replace(/\/+$/, ""),
-    orgSlug,
-    projectSlug: projectSlug || "",
-    projects,
-  };
-  if (existing >= 0) {
-    config.instances[existing] = instance;
-  } else {
-    config.instances.push(instance);
-  }
-
-  if (!config.defaultInstance) config.defaultInstance = name;
-
-  saveConfig(config);
-  console.log(`Instance "${name}" saved to ${configPath}`);
-  if (projects.length > 0) {
-    console.log(`Projects: ${projects.join(", ")}`);
-  }
-  process.exit(0);
-}
-
-// Non-interactive: setup remove <name>
-if (args[0] === "remove" && args.length >= 2) {
-  const name = args[1];
-  const config = loadConfig();
-
-  if (!config || !config.instances) {
-    console.error("No multi-instance config found.");
-    process.exit(1);
-  }
-
-  config.instances = config.instances.filter((i) => i.name !== name);
-  if (config.defaultInstance === name) {
-    config.defaultInstance = config.instances[0]?.name || null;
-  }
-
-  saveConfig(config);
-  console.log(`Instance "${name}" removed.`);
-  process.exit(0);
-}
-
-// Non-interactive: setup <token> <baseUrl> <orgSlug> [projectSlug]
-if (args.length >= 3 && args[0] !== "add" && args[0] !== "remove") {
-  const [token, baseUrl, orgSlug, projectSlug] = args;
-  saveConfig({
-    token,
-    baseUrl: baseUrl.replace(/\/+$/, ""),
-    orgSlug,
-    projectSlug: projectSlug || "",
-  });
-  console.log(`Config saved to ${configPath}`);
-  process.exit(0);
-}
-
-// Interactive mode
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout,
-});
-
-function ask(question) {
-  return new Promise((resolve) => {
-    rl.question(question, resolve);
-  });
-}
-
-async function setup() {
-  const existing = loadConfig();
-  const hasInstances = existing?.instances?.length > 0;
-  const isOldFormat = existing?.token && !existing?.instances;
-
-  console.log("\n=== Sentry MCP Setup ===\n");
-
-  if (hasInstances || isOldFormat) {
-    if (isOldFormat) {
-      console.log(`Existing single-instance config found (${existing.baseUrl})\n`);
-    } else {
-      console.log("Existing instances:");
-      for (const inst of existing.instances) {
-        const isDefault = inst.name === existing.defaultInstance ? " (default)" : "";
-        const projs = inst.projects?.length > 0 ? ` [${inst.projects.join(", ")}]` : "";
-        console.log(`  - ${inst.name}${isDefault}: ${inst.baseUrl} (org: ${inst.orgSlug})${projs}`);
-      }
-      console.log();
-    }
-
-    const action = await ask("Add new instance, or fresh setup? (add/fresh): ");
-    if (action.trim().toLowerCase() === "fresh") {
-      // Fall through to single setup
-    } else {
-      return await addInstance(existing);
-    }
-  }
-
-  console.log("To get your Sentry API token:");
-  console.log("1. Go to https://sentry.io/settings/account/api/auth-tokens/");
-  console.log("   (or your self-hosted Sentry Settings > API > Auth Tokens)");
-  console.log("2. Create a new token with scopes: event:read, project:read, org:read, member:read");
-  console.log("3. Copy the token\n");
-
-  const token = await ask("Sentry API token: ");
-  const baseUrl = await ask("Sentry base URL (e.g., https://sentry.io or https://my-org.sentry.io): ");
-  const orgSlug = await ask("Organization slug: ");
-  const projectSlug = await ask("Default project slug (optional, press Enter to skip): ");
-
-  saveConfig({
-    token: token.trim(),
-    baseUrl: baseUrl.trim().replace(/\/+$/, ""),
-    orgSlug: orgSlug.trim(),
-    projectSlug: projectSlug.trim() || "",
-  });
-  console.log(`\nConfig saved to ${configPath}`);
-
-  printSetupComplete();
-  rl.close();
-}
-
-async function addInstance(config) {
-  // Migrate old format if needed
-  if (config.token && !config.instances) {
-    const oldName = await ask("Name for your existing instance (e.g., work): ");
-    const oldProjects = await ask("Project slugs for existing instance (comma-separated): ");
-    config = {
-      instances: [{
-        name: oldName.trim() || "default",
-        token: config.token,
-        baseUrl: config.baseUrl,
-        orgSlug: config.orgSlug,
-        projectSlug: config.projectSlug || "",
-        projects: oldProjects.split(",").map((p) => p.trim().toLowerCase()).filter(Boolean),
-      }],
-      defaultInstance: oldName.trim() || "default",
-    };
-  }
-
-  if (!config.instances) config.instances = [];
-
-  console.log("\n--- Add New Instance ---\n");
-  console.log("To get your Sentry API token:");
-  console.log("1. Go to https://sentry.io/settings/account/api/auth-tokens/");
-  console.log("   (or your self-hosted Sentry Settings > API > Auth Tokens)");
-  console.log("2. Create a new token with scopes: event:read, project:read, org:read, member:read");
-  console.log("3. Copy the token\n");
-
-  const name = await ask("Instance name (e.g., personal): ");
-  const token = await ask("Sentry API token: ");
-  const baseUrl = await ask("Sentry base URL (e.g., https://sentry.io or https://my-org.sentry.io): ");
-  const orgSlug = await ask("Organization slug: ");
-  const projectSlug = await ask("Default project slug (optional, press Enter to skip): ");
-  const projectsInput = await ask("Project slugs to route to this instance (comma-separated, optional): ");
-  const projects = projectsInput.split(",").map((p) => p.trim().toLowerCase()).filter(Boolean);
-
-  const instance = {
-    name: name.trim(),
-    token: token.trim(),
-    baseUrl: baseUrl.trim().replace(/\/+$/, ""),
-    orgSlug: orgSlug.trim(),
-    projectSlug: projectSlug.trim() || "",
-    projects,
-  };
-
-  // Replace or add
-  const idx = config.instances.findIndex((i) => i.name === instance.name);
-  if (idx >= 0) {
-    config.instances[idx] = instance;
-  } else {
-    config.instances.push(instance);
-  }
-
-  if (!config.defaultInstance) config.defaultInstance = instance.name;
-
-  const setDefault = await ask(`Set "${instance.name}" as default? (y/N): `);
-  if (setDefault.trim().toLowerCase() === "y") {
-    config.defaultInstance = instance.name;
-  }
-
-  saveConfig(config);
-  console.log(`\nInstance "${instance.name}" saved to ${configPath}`);
-
-  console.log("\nAll instances:");
-  for (const inst of config.instances) {
-    const isDefault = inst.name === config.defaultInstance ? " (default)" : "";
-    const projs = inst.projects?.length > 0 ? ` [${inst.projects.join(", ")}]` : "";
-    console.log(`  - ${inst.name}${isDefault}: ${inst.baseUrl} (org: ${inst.orgSlug})${projs}`);
-  }
-
-  printSetupComplete();
-  rl.close();
-}
-
-function printSetupComplete() {
-  console.log("\n=== Setup Complete ===");
-  console.log("\nIf you haven't already, add to Claude Code with:\n");
-  console.log("  claude mcp add --transport stdio sentry -- npx -y @rui.branco/sentry-mcp");
-  console.log("\nThen restart Claude Code and run /mcp to verify.");
-}
-
-setup().catch((e) => {
-  console.error("Setup failed:", e.message);
-  rl.close();
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+const readline = require("readline");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const configDir = path.join(os.homedir(), ".config/sentry-mcp");
+const configPath = path.join(configDir, "config.json");
+
+// Check for command line arguments
+let args = process.argv.slice(2);
+// Skip "setup" arg if called via index.js
+if (args[0] === "setup") args = args.slice(1);
+
+// Load existing config if present
+function loadConfig() {
+  try {
+    if (fs.existsSync(configPath)) {
+      return JSON.parse(fs.readFileSync(configPath, "utf8"));
+    }
+  } catch {}
+  return null;
+}
+
+function saveConfig(config) {
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true });
+  }
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+}
+
+// Non-interactive: setup add <name> <token> <baseUrl> <orgSlug> [projectSlug] [projects...]
+if (args[0] === "add" && args.length >= 4) {
+  const [, name, token, baseUrl, orgSlug, projectSlug, ...projectArgs] = args;
+  const projects = projectArgs.length > 0
+    ? projectArgs.join(",").split(",").map((p) => p.trim().toLowerCase()).filter(Boolean)
+    : [];
+
+  const config = loadConfig() || {};
+
+  // Migrate old format if needed
+  if (config.token && !config.instances) {
+    config.instances = [{
+      name: "default",
+      token: config.token,
+      baseUrl: config.baseUrl,
+      orgSlug: config.orgSlug,
+      projectSlug: config.projectSlug || "",
+      projects: [],
+    }];
+    config.defaultInstance = "default";
+    delete config.token;
+    delete config.baseUrl;
+    delete config.orgSlug;
+    delete config.projectSlug;
+  }
+
+  if (!config.instances) config.instances = [];
+
+  // Replace or add instance
+  const existing = config.instances.findIndex((i) => i.name === name);
+  const instance = {
+    name,
+    token,
+    baseUrl: baseUrl.replace(/\/+$/, ""),
+    orgSlug,
+    projectSlug: projectSlug || "",
+    projects,
+  };
+  if (existing >= 0) {
+    config.instances[existing] = instance;
+  } else {
+    config.instances.push(instance);
+  }
+
+  if (!config.defaultInstance) config.defaultInstance = name;
+
+  saveConfig(config);
+  console.log(`Instance "${name}" saved to ${configPath}`);
+  if (projects.length > 0) {
+    console.log(`Projects: ${projects.join(", ")}`);
+  }
+  process.exit(0);
+}
+
+// Non-interactive: setup remove <name>
+if (args[0] === "remove" && args.length >= 2) {
+  const name = args[1];
+  const config = loadConfig();
+
+  if (!config || !config.instances) {
+    console.error("No multi-instance config found.");
+    process.exit(1);
+  }
+
+  config.instances = config.instances.filter((i) => i.name !== name);
+  if (config.defaultInstance === name) {
+    config.defaultInstance = config.instances[0]?.name || null;
+  }
+
+  saveConfig(config);
+  console.log(`Instance "${name}" removed.`);
+  process.exit(0);
+}
+
+// Non-interactive: setup <token> <baseUrl> <orgSlug> [projectSlug]
+if (args.length >= 3 && args[0] !== "add" && args[0] !== "remove") {
+  const [token, baseUrl, orgSlug, projectSlug] = args;
+  saveConfig({
+    token,
+    baseUrl: baseUrl.replace(/\/+$/, ""),
+    orgSlug,
+    projectSlug: projectSlug || "",
+  });
+  console.log(`Config saved to ${configPath}`);
+  process.exit(0);
+}
+
+// Interactive mode
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+function ask(question) {
+  return new Promise((resolve) => {
+    rl.question(question, resolve);
+  });
+}
+
+async function setup() {
+  const existing = loadConfig();
+  const hasInstances = existing?.instances?.length > 0;
+  const isOldFormat = existing?.token && !existing?.instances;
+
+  console.log("\n=== Sentry MCP Setup ===\n");
+
+  if (hasInstances || isOldFormat) {
+    if (isOldFormat) {
+      console.log(`Existing single-instance config found (${existing.baseUrl})\n`);
+    } else {
+      console.log("Existing instances:");
+      for (const inst of existing.instances) {
+        const isDefault = inst.name === existing.defaultInstance ? " (default)" : "";
+        const projs = inst.projects?.length > 0 ? ` [${inst.projects.join(", ")}]` : "";
+        console.log(`  - ${inst.name}${isDefault}: ${inst.baseUrl} (org: ${inst.orgSlug})${projs}`);
+      }
+      console.log();
+    }
+
+    const action = await ask("Add new instance, or fresh setup? (add/fresh): ");
+    if (action.trim().toLowerCase() === "fresh") {
+      // Fall through to single setup
+    } else {
+      return await addInstance(existing);
+    }
+  }
+
+  console.log("To get your Sentry API token:");
+  console.log("1. Go to https://sentry.io/settings/account/api/auth-tokens/");
+  console.log("   (or your self-hosted Sentry Settings > API > Auth Tokens)");
+  console.log("2. Create a new token with scopes: event:read, project:read, org:read, member:read");
+  console.log("3. Copy the token\n");
+
+  const token = await ask("Sentry API token: ");
+  const baseUrl = await ask("Sentry base URL (e.g., https://sentry.io or https://my-org.sentry.io): ");
+  const orgSlug = await ask("Organization slug: ");
+  const projectSlug = await ask("Default project slug (optional, press Enter to skip): ");
+
+  saveConfig({
+    token: token.trim(),
+    baseUrl: baseUrl.trim().replace(/\/+$/, ""),
+    orgSlug: orgSlug.trim(),
+    projectSlug: projectSlug.trim() || "",
+  });
+  console.log(`\nConfig saved to ${configPath}`);
+
+  printSetupComplete();
+  rl.close();
+}
+
+async function addInstance(config) {
+  // Migrate old format if needed
+  if (config.token && !config.instances) {
+    const oldName = await ask("Name for your existing instance (e.g., work): ");
+    const oldProjects = await ask("Project slugs for existing instance (comma-separated): ");
+    config = {
+      instances: [{
+        name: oldName.trim() || "default",
+        token: config.token,
+        baseUrl: config.baseUrl,
+        orgSlug: config.orgSlug,
+        projectSlug: config.projectSlug || "",
+        projects: oldProjects.split(",").map((p) => p.trim().toLowerCase()).filter(Boolean),
+      }],
+      defaultInstance: oldName.trim() || "default",
+    };
+  }
+
+  if (!config.instances) config.instances = [];
+
+  console.log("\n--- Add New Instance ---\n");
+  console.log("To get your Sentry API token:");
+  console.log("1. Go to https://sentry.io/settings/account/api/auth-tokens/");
+  console.log("   (or your self-hosted Sentry Settings > API > Auth Tokens)");
+  console.log("2. Create a new token with scopes: event:read, project:read, org:read, member:read");
+  console.log("3. Copy the token\n");
+
+  const name = await ask("Instance name (e.g., personal): ");
+  const token = await ask("Sentry API token: ");
+  const baseUrl = await ask("Sentry base URL (e.g., https://sentry.io or https://my-org.sentry.io): ");
+  const orgSlug = await ask("Organization slug: ");
+  const projectSlug = await ask("Default project slug (optional, press Enter to skip): ");
+  const projectsInput = await ask("Project slugs to route to this instance (comma-separated, optional): ");
+  const projects = projectsInput.split(",").map((p) => p.trim().toLowerCase()).filter(Boolean);
+
+  const instance = {
+    name: name.trim(),
+    token: token.trim(),
+    baseUrl: baseUrl.trim().replace(/\/+$/, ""),
+    orgSlug: orgSlug.trim(),
+    projectSlug: projectSlug.trim() || "",
+    projects,
+  };
+
+  // Replace or add
+  const idx = config.instances.findIndex((i) => i.name === instance.name);
+  if (idx >= 0) {
+    config.instances[idx] = instance;
+  } else {
+    config.instances.push(instance);
+  }
+
+  if (!config.defaultInstance) config.defaultInstance = instance.name;
+
+  const setDefault = await ask(`Set "${instance.name}" as default? (y/N): `);
+  if (setDefault.trim().toLowerCase() === "y") {
+    config.defaultInstance = instance.name;
+  }
+
+  saveConfig(config);
+  console.log(`\nInstance "${instance.name}" saved to ${configPath}`);
+
+  console.log("\nAll instances:");
+  for (const inst of config.instances) {
+    const isDefault = inst.name === config.defaultInstance ? " (default)" : "";
+    const projs = inst.projects?.length > 0 ? ` [${inst.projects.join(", ")}]` : "";
+    console.log(`  - ${inst.name}${isDefault}: ${inst.baseUrl} (org: ${inst.orgSlug})${projs}`);
+  }
+
+  printSetupComplete();
+  rl.close();
+}
+
+function printSetupComplete() {
+  console.log("\n=== Setup Complete ===");
+  console.log("\nIf you haven't already, add to Claude Code with:\n");
+  console.log("  claude mcp add --transport stdio sentry -- npx -y @rui.branco/sentry-mcp");
+  console.log("\nThen restart Claude Code and run /mcp to verify.");
+}
+
+setup().catch((e) => {
+  console.error("Setup failed:", e.message);
+  rl.close();
+  process.exit(1);
+});