@extn/segi-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Extension Co., Ltd.
+
+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,46 @@
+# @extn/segi-mcp
+
+Read-only MCP server for the **segi** error-monitoring platform. Connect
+Claude (Code / Desktop) or any MCP client to your segi organization and let
+the agent read issues, events, and stack traces — then diagnose and fix the
+bugs in your own codebase.
+
+## Setup
+
+1. In the segi console, go to **Organization → API keys** and create a key.
+   The plaintext key (`segi_sk_live_…`) is shown **once** — copy it.
+2. Add the server to Claude Code:
+
+```bash
+claude mcp add segi -e SEGI_SECRET_KEY=segi_sk_live_xxx -- npx -y @extn/segi-mcp
+```
+
+Environment variables:
+
+| Variable | Required | Description |
+|---|---|---|
+| `SEGI_SECRET_KEY` | yes | Organization API key from the segi console |
+| `SEGI_API_URL` | no | API base URL (default `https://segiapi.extn.ai`) |
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `list_projects` | Projects the key can read (call first to get project ids) |
+| `get_overview` | Org-wide health: per-project counts, top unresolved issues, sparklines |
+| `list_issues` | Search/filter a project's issues (status, level, text search, time range) |
+| `get_issue` | Issue detail + latest event with full stack trace |
+| `get_issue_events` | Paginated occurrences of one issue |
+| `search_events` | Search the raw event stream |
+| `get_event` | Full detail of a single event by eventId |
+| `get_project_stats` | Project dashboard summary + 24h timeseries |
+
+All tools are read-only. Keys are org-scoped (optionally restricted to a
+single project) and rate-limited per minute; revoke them any time from the
+console — revocation is immediate.
+
+## Example prompts
+
+- "segi에서 지금 제일 시끄러운 에러가 뭐야? 원인 찾아서 고쳐줘."
+- "What errors spiked after yesterday's deploy? Show me the stack traces."
+- "Fix the top unresolved FATAL issue in the api project."

package/dist/index.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+var API_BASE = (process.env.SEGI_API_URL ?? "https://segiapi.extn.ai").replace(
+  /\/$/,
+  ""
+);
+var SECRET_KEY = process.env.SEGI_SECRET_KEY;
+if (!SECRET_KEY) {
+  console.error(
+    "segi-mcp: SEGI_SECRET_KEY is not set. Create an organization API key in the segi console (Organization \u2192 API keys) and pass it via the SEGI_SECRET_KEY environment variable."
+  );
+  process.exit(1);
+}
+async function apiGet(path, params) {
+  const url = new URL(`${API_BASE}${path}`);
+  for (const [k, v] of Object.entries(params ?? {})) {
+    if (v !== void 0 && v !== "") url.searchParams.set(k, String(v));
+  }
+  const res = await fetch(url, {
+    headers: { authorization: `Bearer ${SECRET_KEY}` }
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(
+      `segi API ${res.status} ${res.statusText} for ${path}: ${body.slice(0, 500)}`
+    );
+  }
+  return res.json();
+}
+function textResult(payload) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: typeof payload === "string" ? payload : JSON.stringify(payload, null, 2)
+      }
+    ]
+  };
+}
+function errorResult(err) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: err instanceof Error ? err.message : String(err)
+      }
+    ],
+    isError: true
+  };
+}
+var PAGING_PROPS = {
+  page: { type: "number", description: "1-based page number. Default 1." },
+  pageSize: {
+    type: "number",
+    description: "Items per page (max 100). Default 20."
+  }
+};
+var server = new Server(
+  { name: "segi-mcp", version: "0.1.0" },
+  { capabilities: { tools: {} } }
+);
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "list_projects",
+      description: "List the segi projects this API key can read (id, name, slug, platform). Call this first to discover project ids \u2014 every per-project tool needs one.",
+      inputSchema: { type: "object", properties: {} },
+      annotations: { readOnlyHint: true }
+    },
+    {
+      name: "get_overview",
+      description: "Organization-wide health overview: per-project event counts (today / 7d), unresolved issue counts by severity, the loudest unresolved issues across all projects, and 24h activity sparklines. Use this to answer 'how is my service doing?' and to decide which project/issue to drill into next.",
+      inputSchema: { type: "object", properties: {} },
+      annotations: { readOnlyHint: true }
+    },
+    {
+      name: "list_issues",
+      description: "Search a project's issues (grouped errors). Filter by status (UNRESOLVED/RESOLVED/IGNORED), level (DEBUG/INFO/WARNING/ERROR/FATAL), environment, time range, or free-text search over title/message/culprit. Sorted by most-recently-seen. Each item has eventCount/userCount so you can prioritize. Follow up with get_issue for the stack trace.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          projectId: { type: "string", description: "Project id from list_projects." },
+          status: { type: "string", enum: ["UNRESOLVED", "RESOLVED", "IGNORED"] },
+          level: {
+            type: "string",
+            enum: ["DEBUG", "INFO", "WARNING", "ERROR", "FATAL"]
+          },
+          environment: { type: "string", description: "e.g. production, staging" },
+          search: {
+            type: "string",
+            description: "Substring match on issue title / message / culprit."
+          },
+          from: { type: "string", description: "ISO-8601 lower bound on lastSeenAt." },
+          to: { type: "string", description: "ISO-8601 upper bound on lastSeenAt." },
+          ...PAGING_PROPS
+        },
+        required: ["projectId"]
+      },
+      annotations: { readOnlyHint: true }
+    },
+    {
+      name: "get_issue",
+      description: "Full detail of one issue plus its most recent event \u2014 including the stack trace, error name, culprit (file/function), runtime, release, and breadcrumbs. This is usually all you need to locate the buggy code and fix it. Use get_issue_events if you need more occurrences to compare.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          projectId: { type: "string" },
+          issueId: { type: "string", description: "Issue id from list_issues." }
+        },
+        required: ["projectId", "issueId"]
+      },
+      annotations: { readOnlyHint: true }
+    },
+    {
+      name: "get_issue_events",
+      description: "Paginated raw events (occurrences) of one issue, newest first, with stack traces and context. Compare several occurrences to spot patterns (same browser? same release? same user flow?) when one sample isn't conclusive.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          projectId: { type: "string" },
+          issueId: { type: "string" },
+          ...PAGING_PROPS
+        },
+        required: ["projectId", "issueId"]
+      },
+      annotations: { readOnlyHint: true }
+    },
+    {
+      name: "search_events",
+      description: "Search a project's raw event stream (not grouped into issues). Filter by level, environment, release, transaction, time range, or free-text search over message/errorName/transaction. Returns a light projection; fetch one event with get_event for the full stack trace.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          projectId: { type: "string" },
+          level: {
+            type: "string",
+            enum: ["DEBUG", "INFO", "WARNING", "ERROR", "FATAL"]
+          },
+          environment: { type: "string" },
+          release: { type: "string" },
+          transaction: { type: "string", description: "Route/transaction name." },
+          search: {
+            type: "string",
+            description: "Substring match on message / errorName / transaction."
+          },
+          from: { type: "string", description: "ISO-8601 lower bound on receivedAt." },
+          to: { type: "string", description: "ISO-8601 upper bound on receivedAt." },
+          ...PAGING_PROPS
+        },
+        required: ["projectId"]
+      },
+      annotations: { readOnlyHint: true }
+    },
+    {
+      name: "get_event",
+      description: "Full detail of a single event by its eventId (the string id, e.g. from search_events items): stack trace, tags, extra context, breadcrumbs, request info, device/os/browser.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          projectId: { type: "string" },
+          eventId: {
+            type: "string",
+            description: "The event's eventId string (not the numeric row id)."
+          }
+        },
+        required: ["projectId", "eventId"]
+      },
+      annotations: { readOnlyHint: true }
+    },
+    {
+      name: "get_project_stats",
+      description: "One project's dashboard stats: events today/7d, unresolved issue counts by level, top unresolved issues, 10 most recent events, and a 24h per-minute timeseries by level. Use to check a project's health or verify an error stopped after a fix was deployed.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          projectId: { type: "string" }
+        },
+        required: ["projectId"]
+      },
+      annotations: { readOnlyHint: true }
+    }
+  ]
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: rawArgs = {} } = request.params;
+  const args = rawArgs;
+  const projectId = args.projectId;
+  try {
+    switch (name) {
+      case "list_projects":
+        return textResult(await apiGet("/api/mcp/v1/projects"));
+      case "get_overview":
+        return textResult(await apiGet("/api/mcp/v1/overview"));
+      case "list_issues":
+        return textResult(
+          await apiGet(`/api/mcp/v1/projects/${projectId}/issues`, {
+            status: args.status,
+            level: args.level,
+            environment: args.environment,
+            search: args.search,
+            from: args.from,
+            to: args.to,
+            page: args.page,
+            pageSize: args.pageSize
+          })
+        );
+      case "get_issue":
+        return textResult(
+          await apiGet(
+            `/api/mcp/v1/projects/${projectId}/issues/${args.issueId}`
+          )
+        );
+      case "get_issue_events":
+        return textResult(
+          await apiGet(
+            `/api/mcp/v1/projects/${projectId}/issues/${args.issueId}/events`,
+            { page: args.page, pageSize: args.pageSize }
+          )
+        );
+      case "search_events":
+        return textResult(
+          await apiGet(`/api/mcp/v1/projects/${projectId}/events`, {
+            level: args.level,
+            environment: args.environment,
+            release: args.release,
+            transaction: args.transaction,
+            search: args.search,
+            from: args.from,
+            to: args.to,
+            page: args.page,
+            pageSize: args.pageSize
+          })
+        );
+      case "get_event":
+        return textResult(
+          await apiGet(
+            `/api/mcp/v1/projects/${projectId}/events/${args.eventId}`
+          )
+        );
+      case "get_project_stats": {
+        const [summary, timeseries] = await Promise.all([
+          apiGet(`/api/mcp/v1/projects/${projectId}/summary`),
+          apiGet(`/api/mcp/v1/projects/${projectId}/timeseries`)
+        ]);
+        return textResult({ summary, timeseries });
+      }
+      default:
+        return {
+          content: [{ type: "text", text: `unknown tool: ${name}` }],
+          isError: true
+        };
+    }
+  } catch (err) {
+    return errorResult(err);
+  }
+});
+var transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@extn/segi-mcp",
+  "version": "0.1.0",
+  "description": "MCP server that lets an AI agent (Claude) read segi error-monitoring data — issues, events, stack traces, project stats — using an organization API key",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "segi-mcp": "./dist/index.js"
+  },
+  "files": ["dist", "README.md"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run clean && pnpm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.3"
+  }
+}