@unclick/mcp-server 0.2.3 → 0.2.5

package/dist/linear-tool.js

@@ -0,0 +1,186 @@
+// ── Linear GraphQL API tool ────────────────────────────────────────────────
+// Wraps the Linear GraphQL API (https://api.linear.app/graphql) via fetch.
+// Auth: API key passed as api_key.
+// No external dependencies.
+const LINEAR_API = "https://api.linear.app/graphql";
+// ── GraphQL helper ─────────────────────────────────────────────────────────────
+async function linearQuery(apiKey, query, variables) {
+    let response;
+    try {
+        response = await fetch(LINEAR_API, {
+            method: "POST",
+            headers: {
+                Authorization: apiKey,
+                "Content-Type": "application/json",
+                "User-Agent": "UnClick-MCP/1.0",
+            },
+            body: JSON.stringify({ query, variables }),
+        });
+    }
+    catch (err) {
+        return { error: `Network error reaching Linear API: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    const text = await response.text();
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        return { error: `Invalid JSON from Linear: ${text}` };
+    }
+    if (response.status === 401)
+        return { error: "Linear API key is invalid. Check your api_key.", status: 401 };
+    if (response.status === 429)
+        return { error: "Linear rate limit exceeded. Please wait and retry.", status: 429 };
+    if (!response.ok) {
+        return { error: `Linear API error ${response.status}: ${text}`, status: response.status };
+    }
+    if (data.errors) {
+        const errs = data.errors.map((e) => e.message).join("; ");
+        return { error: `Linear GraphQL error: ${errs}` };
+    }
+    return data.data;
+}
+// ── Action implementations ─────────────────────────────────────────────────────
+async function listIssues(apiKey, args) {
+    const first = args.first ? Number(args.first) : 25;
+    const teamId = args.team_id ? String(args.team_id) : undefined;
+    const stateId = args.state_id ? String(args.state_id) : undefined;
+    const filter = {};
+    if (teamId)
+        filter.team = { id: { eq: teamId } };
+    if (stateId)
+        filter.state = { id: { eq: stateId } };
+    const hasFilter = Object.keys(filter).length > 0;
+    return linearQuery(apiKey, `
+    query ListIssues($first: Int, $filter: IssueFilter) {
+      issues(first: $first, filter: $filter) {
+        nodes {
+          id
+          identifier
+          title
+          description
+          priority
+          state { name }
+          assignee { name email }
+          team { name }
+          createdAt
+          updatedAt
+          url
+        }
+      }
+    }
+  `, { first, filter: hasFilter ? filter : undefined });
+}
+async function createIssue(apiKey, args) {
+    const title = String(args.title ?? "").trim();
+    const teamId = String(args.team_id ?? "").trim();
+    if (!title)
+        return { error: "title is required." };
+    if (!teamId)
+        return { error: "team_id is required." };
+    const input = { title, teamId };
+    if (args.description)
+        input.description = String(args.description);
+    if (args.priority)
+        input.priority = Number(args.priority);
+    if (args.assignee_id)
+        input.assigneeId = String(args.assignee_id);
+    if (args.state_id)
+        input.stateId = String(args.state_id);
+    return linearQuery(apiKey, `
+    mutation CreateIssue($input: IssueCreateInput!) {
+      issueCreate(input: $input) {
+        success
+        issue {
+          id
+          identifier
+          title
+          url
+          state { name }
+        }
+      }
+    }
+  `, { input });
+}
+async function getProject(apiKey, args) {
+    const id = String(args.project_id ?? "").trim();
+    if (!id)
+        return { error: "project_id is required." };
+    return linearQuery(apiKey, `
+    query GetProject($id: String!) {
+      project(id: $id) {
+        id
+        name
+        description
+        state
+        progress
+        startDate
+        targetDate
+        url
+        teams { nodes { id name } }
+      }
+    }
+  `, { id });
+}
+async function listTeams(apiKey) {
+    return linearQuery(apiKey, `
+    query ListTeams {
+      teams {
+        nodes {
+          id
+          name
+          description
+          key
+          timezone
+        }
+      }
+    }
+  `);
+}
+async function searchIssues(apiKey, args) {
+    const term = String(args.query ?? "").trim();
+    const first = args.first ? Number(args.first) : 25;
+    if (!term)
+        return { error: "query is required." };
+    return linearQuery(apiKey, `
+    query SearchIssues($term: String!, $first: Int) {
+      issueSearch(term: $term, first: $first) {
+        nodes {
+          id
+          identifier
+          title
+          description
+          priority
+          state { name }
+          assignee { name }
+          team { name }
+          url
+        }
+      }
+    }
+  `, { term, first });
+}
+// ── Public dispatcher ──────────────────────────────────────────────────────────
+export async function linearAction(action, args) {
+    const apiKey = String(args.api_key ?? "").trim();
+    if (!apiKey)
+        return { error: "api_key is required." };
+    try {
+        switch (action) {
+            case "list_issues": return listIssues(apiKey, args);
+            case "create_issue": return createIssue(apiKey, args);
+            case "get_project": return getProject(apiKey, args);
+            case "list_teams": return listTeams(apiKey);
+            case "search_issues": return searchIssues(apiKey, args);
+            default:
+                return {
+                    error: `Unknown Linear action: "${action}". Valid actions: list_issues, create_issue, get_project, list_teams, search_issues.`,
+                };
+        }
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=linear-tool.js.map

package/dist/linear-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-tool.js","sourceRoot":"","sources":["../src/linear-tool.ts"],"names":[],"mappings":"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"}

package/dist/local-catalog-handlers.d.ts

@@ -0,0 +1,3 @@
+export type LocalHandler = (args: Record<string, unknown>) => unknown | Promise<unknown>;
+export declare const LOCAL_CATALOG_HANDLERS: Record<string, LocalHandler>;
+//# sourceMappingURL=local-catalog-handlers.d.ts.map

package/dist/local-catalog-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-catalog-handlers.d.ts","sourceRoot":"","sources":["../src/local-catalog-handlers.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAsWzF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA6wB/D,CAAC"}