@yinuo-ngm/mcp-server 0.1.1 → 0.1.3

package/lib/tools/hub-v2/issues.tools.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2IssuesTools = hubV2IssuesTools;
+const client_1 = require("./client");
+const index_1 = require("./config/index");
+const schemas_1 = require("./schemas");
+const result_1 = require("../../utils/result");
+function hubV2IssuesTools() {
+    return [
+        {
+            name: "hub_v2_issues_list",
+            description: "List Hub V2 issues with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.issuesListSchema,
+            async handler(args) {
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl("/issues", {
+                    page: args.page ?? 1,
+                    pageSize: args.pageSize ?? 20,
+                    keyword: args.keyword,
+                    status: args.status,
+                    priority: args.priority,
+                    assigneeId: args.assigneeId,
+                    verifierId: args.verifierId,
+                    rdItemId: args.rdItemId,
+                }));
+                return (0, result_1.ok)("hub_v2_issues_list", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_get",
+            description: "Read one Hub V2 issue by id with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.issueGetSchema,
+            async handler(args) {
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl(`/issues/${encodeURIComponent(args.issueId)}`));
+                return (0, result_1.ok)("hub_v2_issues_get", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_create",
+            description: "Preview or create a Hub V2 issue with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueCreateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = "/issues";
+                const body = (0, client_1.compact)({
+                    title: args.title,
+                    description: args.description,
+                    type: args.type,
+                    priority: args.priority,
+                    assigneeId: args.assigneeId,
+                    verifierId: args.verifierId,
+                    rdItemId: args.rdItemId,
+                    moduleCode: args.moduleCode,
+                    versionCode: args.versionCode,
+                    environmentCode: args.environmentCode,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_create", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:create:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_create", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_comment",
+            description: "Preview or add a Hub V2 issue comment with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueCommentSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}/comments`;
+                const body = (0, client_1.compact)({
+                    content: args.content,
+                    mentions: args.mentions,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_comment", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:comment:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_comment", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_assign",
+            description: "Preview or assign a Hub V2 issue assignee with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueAssignSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}/assign`;
+                const body = { assigneeId: args.assigneeId };
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_assign", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:assign:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_assign", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_participant_add",
+            description: "Preview or add a Hub V2 issue collaborator, optionally creating a collaborator task branch.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueParticipantAddSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}/participants`;
+                const body = (0, client_1.compact)({
+                    userId: args.userId,
+                    taskTitle: args.taskTitle,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_participant_add", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:participant:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_participant_add", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_branch_create",
+            description: "Preview or create a Hub V2 issue collaboration branch for an existing collaborator.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueBranchCreateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}/branches`;
+                const body = {
+                    ownerUserId: args.ownerUserId,
+                    title: args.title,
+                };
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_branch_create", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:branch:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_branch_create", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_update",
+            description: "Preview or update Hub V2 issue basic fields with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueUpdateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}`;
+                const body = (0, client_1.compactUndefined)({
+                    title: args.title,
+                    description: args.description,
+                    type: args.type,
+                    priority: args.priority,
+                    rdItemId: args.rdItemId,
+                    moduleCode: args.moduleCode,
+                    versionCode: args.versionCode,
+                    environmentCode: args.environmentCode,
+                });
+                if (Object.keys(body).length === 0) {
+                    return (0, result_1.fail)("hub_v2_issues_update", "at least one issue field is required");
+                }
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_update", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "PATCH",
+                            path,
+                            requiredScope: "issue:update:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("PATCH", client.personalUrl(path), body, { preserveNull: true });
+                return (0, result_1.ok)("hub_v2_issues_update", data);
+            },
+        },
+    ];
+}

package/lib/tools/hub-v2/projects.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function hubV2ProjectsTools(): McpToolDefinition[];

package/lib/tools/hub-v2/projects.tools.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2ProjectsTools = hubV2ProjectsTools;
+const client_1 = require("./client");
+const index_1 = require("./config/index");
+const schemas_1 = require("./schemas");
+const result_1 = require("../../utils/result");
+function hubV2ProjectsTools() {
+    return [
+        {
+            name: "hub_v2_projects_list",
+            description: "List locally configured Hub V2 project aliases without exposing tokens.",
+            riskLevel: "read",
+            inputSchema: schemas_1.projectSelectorSchema,
+            handler(args) {
+                return (0, result_1.ok)("hub_v2_projects_list", (0, index_1.listConfiguredProjects)(args.project ?? args.projectKey));
+            },
+        },
+        {
+            name: "hub_v2_projects_get",
+            description: "Get one locally configured Hub V2 project summary without exposing tokens.",
+            riskLevel: "read",
+            inputSchema: schemas_1.projectSelectorSchema,
+            handler(args) {
+                return (0, result_1.ok)("hub_v2_projects_get", (0, index_1.getConfiguredProject)(args));
+            },
+        },
+        {
+            name: "hub_v2_project_members_list",
+            description: "List Hub V2 project members with Project Token for assignment and mention candidates.",
+            riskLevel: "read",
+            inputSchema: schemas_1.projectMembersListSchema,
+            async handler(args) {
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl("/members"));
+                return (0, result_1.ok)("hub_v2_project_members_list", data);
+            },
+        },
+    ];
+}

package/lib/tools/hub-v2/raw.d.ts

@@ -0,0 +1,8 @@
+import { HubV2Client } from "./client";
+export declare function readRawAsBase64(client: HubV2Client, url: string, maxBytes?: number): Promise<{
+    contentBase64: string;
+    contentType: string;
+    fileName: string | null;
+    sizeBytes: number;
+    truncated: boolean;
+}>;

package/lib/tools/hub-v2/raw.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRawAsBase64 = readRawAsBase64;
+async function readRawAsBase64(client, url, maxBytes) {
+    const limit = maxBytes ?? 1024 * 1024;
+    const raw = await client.raw("GET", url);
+    if (raw.content.byteLength > limit) {
+        throw new Error(`raw file is too large: ${raw.content.byteLength} bytes exceeds maxBytes=${limit}`);
+    }
+    return {
+        contentBase64: raw.content.toString("base64"),
+        contentType: raw.contentType,
+        fileName: extractFileName(raw.contentDisposition),
+        sizeBytes: raw.content.byteLength,
+        truncated: false,
+    };
+}
+function extractFileName(contentDisposition) {
+    if (!contentDisposition) {
+        return null;
+    }
+    const utf8Match = /filename\*=UTF-8''([^;]+)/i.exec(contentDisposition);
+    if (utf8Match) {
+        try {
+            return decodeURIComponent(utf8Match[1]);
+        }
+        catch {
+            return utf8Match[1];
+        }
+    }
+    const asciiMatch = /filename="([^"]+)"/i.exec(contentDisposition);
+    return asciiMatch?.[1] ?? null;
+}

package/lib/tools/hub-v2/rd.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function hubV2RdTools(): McpToolDefinition[];