@xurenxiang1219/pingcode-mcp 0.3.1

package/dist/sources/write-source.d.ts

@@ -0,0 +1,461 @@
+import type { PingCodeWriteClientLike } from "../pingcode/client.js";
+import { testCaseSchema } from "../pingcode/schemas.js";
+export interface TaskWriteFields {
+    projectId?: string;
+    typeId?: string;
+    title?: string;
+    description?: string;
+    startAt?: number;
+    endAt?: number;
+    priorityId?: string;
+    stateId?: string;
+    assigneeId?: string;
+    parentId?: string;
+    sprintId?: string;
+    versionId?: string;
+    versionIds?: string[];
+    boardId?: string;
+    entryId?: string;
+    swimlaneId?: string;
+    phaseId?: string;
+    storyPoints?: number;
+    estimatedWorkload?: number;
+    remainingWorkload?: number;
+    properties?: Record<string, unknown>;
+    participantIds?: string[];
+}
+export interface TestCaseStepWriteFields {
+    stepId?: string;
+    description: string;
+    expectedValue?: string;
+    isGroup?: boolean;
+    groupId?: string;
+}
+export interface TestCaseWriteFields {
+    testLibraryId?: string;
+    title?: string;
+    suiteId?: string;
+    stateId?: string;
+    typeId?: string;
+    importantLevel?: string;
+    importantLevelId?: string;
+    maintenanceId?: string;
+    participantIds?: string[];
+    properties?: Record<string, unknown>;
+    description?: string;
+    precondition?: string;
+    steps?: TestCaseStepWriteFields[];
+}
+export interface BulkTestCaseCreateResult {
+    state: string;
+    case?: ReturnType<typeof testCaseSchema.parse>;
+    error?: unknown;
+}
+export interface ProjectMemberWriteField {
+    id: string;
+    type: "user" | "user_group";
+}
+export interface ProjectCreateFields {
+    name: string;
+    identifier: string;
+    type: "scrum" | "kanban" | "waterfall" | "hybrid";
+    visibility?: "public" | "private";
+    description?: string;
+    assigneeId: string;
+    scopeType?: "organization" | "user_group";
+    scopeId?: string;
+    members?: ProjectMemberWriteField[];
+}
+export interface TestLibraryCreateFields {
+    name: string;
+    identifier: string;
+    description?: string;
+    memberIds?: string[];
+}
+export declare class PingCodeWriteSource {
+    private readonly client;
+    constructor(client: PingCodeWriteClientLike);
+    createTask(fields: TaskWriteFields): Promise<{
+        [x: string]: unknown;
+        id: string;
+        url: string;
+        project: {
+            [x: string]: unknown;
+            id: string;
+            url: string;
+            identifier: string;
+            name: string;
+            type: string;
+        };
+        identifier: string;
+        title: string;
+        type: string;
+        short_id?: string | undefined;
+        html_url?: string | undefined;
+        start_at?: number | null | undefined;
+        end_at?: number | null | undefined;
+        completed_at?: number | null | undefined;
+        parent_id?: string | null | undefined;
+        parent?: {
+            [x: string]: unknown;
+            id: string;
+            url: string;
+            identifier: string;
+            title: string;
+            type: string;
+            short_id?: string | undefined;
+            html_url?: string | undefined;
+            parent_id?: string | null | undefined;
+        } | null | undefined;
+        assignee?: {
+            [x: string]: unknown;
+            id: string;
+            url?: string | undefined;
+            name?: string | undefined;
+            display_name?: string | undefined;
+        } | null | undefined;
+        state?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            type: string;
+            url?: string | undefined;
+            color?: string | undefined;
+        } | null | undefined;
+        priority?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+        } | null | undefined;
+        sprint?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+            start_at?: number | null | undefined;
+            end_at?: number | null | undefined;
+            status?: string | undefined;
+        } | null | undefined;
+        version?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+            start_at?: number | null | undefined;
+            end_at?: number | null | undefined;
+            status?: string | undefined;
+        } | null | undefined;
+        description?: string | null | undefined;
+        properties?: Record<string, unknown> | undefined;
+        tags?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+        }[] | undefined;
+        created_at?: number | undefined;
+        updated_at?: number | undefined;
+        is_archived?: number | boolean | undefined;
+        is_deleted?: number | boolean | undefined;
+    }>;
+    updateTask(taskId: string, fields: TaskWriteFields): Promise<{
+        [x: string]: unknown;
+        id: string;
+        url: string;
+        project: {
+            [x: string]: unknown;
+            id: string;
+            url: string;
+            identifier: string;
+            name: string;
+            type: string;
+        };
+        identifier: string;
+        title: string;
+        type: string;
+        short_id?: string | undefined;
+        html_url?: string | undefined;
+        start_at?: number | null | undefined;
+        end_at?: number | null | undefined;
+        completed_at?: number | null | undefined;
+        parent_id?: string | null | undefined;
+        parent?: {
+            [x: string]: unknown;
+            id: string;
+            url: string;
+            identifier: string;
+            title: string;
+            type: string;
+            short_id?: string | undefined;
+            html_url?: string | undefined;
+            parent_id?: string | null | undefined;
+        } | null | undefined;
+        assignee?: {
+            [x: string]: unknown;
+            id: string;
+            url?: string | undefined;
+            name?: string | undefined;
+            display_name?: string | undefined;
+        } | null | undefined;
+        state?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            type: string;
+            url?: string | undefined;
+            color?: string | undefined;
+        } | null | undefined;
+        priority?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+        } | null | undefined;
+        sprint?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+            start_at?: number | null | undefined;
+            end_at?: number | null | undefined;
+            status?: string | undefined;
+        } | null | undefined;
+        version?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+            start_at?: number | null | undefined;
+            end_at?: number | null | undefined;
+            status?: string | undefined;
+        } | null | undefined;
+        description?: string | null | undefined;
+        properties?: Record<string, unknown> | undefined;
+        tags?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+        }[] | undefined;
+        created_at?: number | undefined;
+        updated_at?: number | undefined;
+        is_archived?: number | boolean | undefined;
+        is_deleted?: number | boolean | undefined;
+    }>;
+    createTestCase(fields: TestCaseWriteFields): Promise<{
+        [x: string]: unknown;
+        id: string;
+        url: string;
+        library: {
+            [x: string]: unknown;
+            id: string;
+            identifier: string;
+            name: string;
+            url?: string | undefined;
+        };
+        identifier: string;
+        title: string;
+        short_id?: string | undefined;
+        html_url?: string | undefined;
+        level?: string | null | undefined;
+        important_level?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+        } | null | undefined;
+        suite?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+            paths?: string | undefined;
+        } | null | undefined;
+        state?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+            type?: string | undefined;
+        } | null | undefined;
+        type?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+        } | null | undefined;
+        maintenance?: {
+            [x: string]: unknown;
+            id: string;
+            url?: string | undefined;
+            name?: string | undefined;
+            display_name?: string | undefined;
+        } | null | undefined;
+        test_type?: string | null | undefined;
+        description?: string | null | undefined;
+        precondition?: string | null | undefined;
+        properties?: Record<string, unknown> | undefined;
+        steps?: {
+            [x: string]: unknown;
+            description: string;
+            step_id?: string | undefined;
+            expected_value?: string | null | undefined;
+            is_group?: boolean | undefined;
+            group_id?: string | null | undefined;
+        }[] | undefined;
+        created_at?: number | undefined;
+        updated_at?: number | undefined;
+        is_archived?: number | boolean | undefined;
+        is_deleted?: number | boolean | undefined;
+    }>;
+    createTestCasesBulk(fields: TestCaseWriteFields[]): Promise<BulkTestCaseCreateResult[]>;
+    updateTestCase(caseId: string, fields: TestCaseWriteFields): Promise<{
+        [x: string]: unknown;
+        id: string;
+        url: string;
+        library: {
+            [x: string]: unknown;
+            id: string;
+            identifier: string;
+            name: string;
+            url?: string | undefined;
+        };
+        identifier: string;
+        title: string;
+        short_id?: string | undefined;
+        html_url?: string | undefined;
+        level?: string | null | undefined;
+        important_level?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+        } | null | undefined;
+        suite?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+            paths?: string | undefined;
+        } | null | undefined;
+        state?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+            type?: string | undefined;
+        } | null | undefined;
+        type?: {
+            [x: string]: unknown;
+            id: string;
+            name: string;
+            url?: string | undefined;
+        } | null | undefined;
+        maintenance?: {
+            [x: string]: unknown;
+            id: string;
+            url?: string | undefined;
+            name?: string | undefined;
+            display_name?: string | undefined;
+        } | null | undefined;
+        test_type?: string | null | undefined;
+        description?: string | null | undefined;
+        precondition?: string | null | undefined;
+        properties?: Record<string, unknown> | undefined;
+        steps?: {
+            [x: string]: unknown;
+            description: string;
+            step_id?: string | undefined;
+            expected_value?: string | null | undefined;
+            is_group?: boolean | undefined;
+            group_id?: string | null | undefined;
+        }[] | undefined;
+        created_at?: number | undefined;
+        updated_at?: number | undefined;
+        is_archived?: number | boolean | undefined;
+        is_deleted?: number | boolean | undefined;
+    }>;
+    deleteTestCase(caseId: string): Promise<void>;
+    relateTestCaseToWorkItem(testCaseId: string, workItemId: string): Promise<{
+        [x: string]: unknown;
+        id: string;
+        url: string;
+        principal_type: string;
+        target_type: string;
+        principal_id?: string | undefined;
+        principal?: {
+            [x: string]: unknown;
+            id: string;
+        } | undefined;
+        target_id?: string | undefined;
+        target?: {
+            [x: string]: unknown;
+            id: string;
+        } | undefined;
+    }>;
+    createProject(fields: ProjectCreateFields): Promise<{
+        [x: string]: unknown;
+        id: string;
+        identifier: string;
+        name: string;
+        type: string;
+        url?: string | null | undefined;
+        visibility?: string | null | undefined;
+        scope_type?: string | null | undefined;
+        scope_id?: string | null | undefined;
+        is_archived?: number | boolean | null | undefined;
+        is_deleted?: number | boolean | null | undefined;
+        members?: ({
+            [x: string]: unknown;
+            id: string;
+            type: "user" | "user_group";
+            role_id?: string | null | undefined;
+        } | {
+            [x: string]: unknown;
+            id: string;
+            user: {
+                [x: string]: unknown;
+                id: string;
+            };
+            role_id?: string | null | undefined;
+        } | {
+            [x: string]: unknown;
+            id: string;
+            user_group: {
+                [x: string]: unknown;
+                id: string;
+            };
+            role_id?: string | null | undefined;
+        })[] | null | undefined;
+    }>;
+    createTestLibrary(fields: TestLibraryCreateFields): Promise<{
+        [x: string]: unknown;
+        id: string;
+        identifier: string;
+        name: string;
+        url?: string | null | undefined;
+        description?: string | null | undefined;
+        color?: string | null | undefined;
+        members?: {
+            [x: string]: unknown;
+            id?: string | undefined;
+            url?: string | undefined;
+            user?: {
+                [x: string]: unknown;
+                id: string;
+            } | undefined;
+            role_id?: string | null | undefined;
+        }[] | null | undefined;
+        is_archived?: number | boolean | null | undefined;
+        is_deleted?: number | boolean | null | undefined;
+    }>;
+    addProjectMember(projectId: string, member: ProjectMemberWriteField): Promise<{
+        [x: string]: unknown;
+        id: string;
+        type: "user" | "user_group";
+    }>;
+    updateProjectMemberRole(projectId: string, memberId: string, roleId: string): Promise<void>;
+    updateTestLibraryMemberRole(libraryId: string, memberId: string, roleId: string): Promise<void>;
+}
+//# sourceMappingURL=write-source.d.ts.map

package/dist/sources/write-source.d.ts.map

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

package/dist/sources/write-source.js

@@ -0,0 +1,174 @@
+import { z } from "zod";
+import { PingCodeError } from "../pingcode/errors.js";
+import { projectMetadataSchema, projectMemberSchema, relationSchema, testLibraryMetadataSchema, testCaseSchema, workItemSchema, } from "../pingcode/schemas.js";
+import { extractWriteResourceId, unknownWriteResponse, unwrapWriteResponse } from "../pingcode/write-response.js";
+export class PingCodeWriteSource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async createTask(fields) {
+        return workItemSchema.parse(await this.client.post("/v1/pjm/work_items", mapTaskFields(fields)));
+    }
+    async updateTask(taskId, fields) {
+        return workItemSchema.parse(await this.client.patch(`/v1/pjm/work_items/${encodeURIComponent(taskId)}`, mapTaskFields(fields)));
+    }
+    async createTestCase(fields) {
+        return testCaseSchema.parse(await this.client.post("/v1/testhub/cases", mapTestCaseFields(fields)));
+    }
+    async createTestCasesBulk(fields) {
+        const response = await this.client.post("/v1/testhub/cases/bulk", {
+            cases: fields.map(mapTestCaseFields),
+        });
+        const parsed = z
+            .array(z
+            .object({
+            state: z.string(),
+            case: testCaseSchema.optional(),
+            error: z.unknown().optional(),
+        })
+            .passthrough())
+            .safeParse(response);
+        if (!parsed.success) {
+            throw new PingCodeError("PingCode 已接受批量 Test Case 创建请求，但返回内容无法确认各项结果；请求可能已经部分或全部写入。请先使用 pingcode_test_case_list／pingcode_test_case_get 回读，禁止更换幂等键重试", "WRITE_OUTCOME_UNKNOWN", { cause: parsed.error });
+        }
+        return parsed.data;
+    }
+    async updateTestCase(caseId, fields) {
+        return testCaseSchema.parse(await this.client.patch(`/v1/testhub/cases/${encodeURIComponent(caseId)}`, mapTestCaseFields(fields)));
+    }
+    async deleteTestCase(caseId) {
+        if (!this.client.delete) {
+            throw new PingCodeError("当前 PingCode Client 不支持 Test Case 删除请求", "NOT_CONFIGURED");
+        }
+        await this.client.delete(`/v1/testhub/cases/${encodeURIComponent(caseId)}`);
+    }
+    async relateTestCaseToWorkItem(testCaseId, workItemId) {
+        return relationSchema.parse(await this.client.post("/v1/relations", {
+            principal_type: "test_case",
+            principal_id: testCaseId,
+            target_type: "work_item",
+            target_id: workItemId,
+        }));
+    }
+    async createProject(fields) {
+        const raw = unwrapWriteResponse(await this.client.post("/v1/project/projects", mapProjectFields(fields)));
+        const id = extractWriteResourceId(raw);
+        if (id === undefined)
+            throw unknownWriteResponse("项目创建", raw);
+        try {
+            return projectMetadataSchema.parse({
+                ...raw,
+                id,
+                identifier: typeof raw.identifier === "string" ? raw.identifier : fields.identifier,
+                name: typeof raw.name === "string" ? raw.name : fields.name,
+                type: typeof raw.type === "string" ? raw.type : fields.type,
+            });
+        }
+        catch (error) {
+            throw unknownWriteResponse("项目创建", error);
+        }
+    }
+    async createTestLibrary(fields) {
+        const response = unwrapWriteResponse(await this.client.post("/v1/testhub/libraries", mapTestLibraryFields(fields)));
+        const id = extractWriteResourceId(response);
+        if (id === undefined)
+            throw unknownWriteResponse("测试库创建", response);
+        try {
+            return testLibraryMetadataSchema.parse({
+                ...response,
+                id,
+                identifier: typeof response.identifier === "string" ? response.identifier : fields.identifier,
+                name: typeof response.name === "string" ? response.name : fields.name,
+                description: response.description ?? fields.description,
+            });
+        }
+        catch (error) {
+            throw unknownWriteResponse(`测试库创建（identifier '${fields.identifier}'）`, error);
+        }
+    }
+    async addProjectMember(projectId, member) {
+        const response = await this.client.post(`/v1/project/projects/${encodeURIComponent(projectId)}/members`, { member });
+        const wrapped = z.object({ member: projectMemberSchema }).passthrough().safeParse(response);
+        return wrapped.success ? wrapped.data.member : projectMemberSchema.parse(response);
+    }
+    async updateProjectMemberRole(projectId, memberId, roleId) {
+        await this.client.patch(`/v1/project/projects/${encodeURIComponent(projectId)}/members/${encodeURIComponent(memberId)}`, { role_id: roleId });
+    }
+    async updateTestLibraryMemberRole(libraryId, memberId, roleId) {
+        await this.client.patch(`/v1/testhub/libraries/${encodeURIComponent(libraryId)}/members/${encodeURIComponent(memberId)}`, { role_id: roleId });
+    }
+}
+function mapTaskFields(fields) {
+    return compact({
+        project_id: fields.projectId,
+        type_id: fields.typeId,
+        title: fields.title,
+        description: fields.description,
+        start_at: fields.startAt,
+        end_at: fields.endAt,
+        priority_id: fields.priorityId,
+        state_id: fields.stateId,
+        assignee_id: fields.assigneeId,
+        parent_id: fields.parentId,
+        sprint_id: fields.sprintId,
+        version_ids: fields.versionIds ?? (fields.versionId === undefined ? undefined : [fields.versionId]),
+        board_id: fields.boardId,
+        entry_id: fields.entryId,
+        swimlane_id: fields.swimlaneId,
+        phase_id: fields.phaseId,
+        story_points: fields.storyPoints,
+        estimated_workload: fields.estimatedWorkload,
+        remaining_workload: fields.remainingWorkload,
+        properties: fields.properties,
+        participant_ids: fields.participantIds,
+    });
+}
+function mapTestCaseFields(fields) {
+    return compact({
+        test_library_id: fields.testLibraryId,
+        title: fields.title,
+        suite_id: fields.suiteId,
+        state_id: fields.stateId,
+        type_id: fields.typeId,
+        important_level: fields.importantLevel,
+        important_level_id: fields.importantLevelId,
+        maintenance_id: fields.maintenanceId,
+        participant_ids: fields.participantIds,
+        properties: fields.properties,
+        description: fields.description,
+        precondition: fields.precondition,
+        steps: fields.steps?.map((step) => compact({
+            step_id: step.stepId,
+            description: step.description,
+            expected_value: step.expectedValue,
+            is_group: step.isGroup,
+            group_id: step.groupId,
+        })),
+    });
+}
+function mapProjectFields(fields) {
+    return compact({
+        name: fields.name,
+        identifier: fields.identifier,
+        type: fields.type,
+        visibility: fields.visibility,
+        description: fields.description,
+        assignee_id: fields.assigneeId,
+        scope_type: fields.scopeType,
+        scope_id: fields.scopeId,
+        members: fields.members,
+    });
+}
+function mapTestLibraryFields(fields) {
+    return compact({
+        name: fields.name,
+        identifier: fields.identifier,
+        description: fields.description,
+        member_ids: fields.memberIds,
+    });
+}
+function compact(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, nested]) => nested !== undefined));
+}
+//# sourceMappingURL=write-source.js.map

package/dist/sources/write-source.js.map

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

package/dist/transports/bearer-auth.d.ts

@@ -0,0 +1,20 @@
+import type { RequestHandler } from "express";
+import type { OAuthTokenVerifier } from "@modelcontextprotocol/sdk/server/auth/provider.js";
+import type { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
+declare module "express-serve-static-core" {
+    interface Request {
+        auth?: AuthInfo;
+    }
+}
+interface SafeBearerAuthOptions {
+    verifier: OAuthTokenVerifier;
+    requiredScopes?: string[];
+    resourceMetadataUrl?: string;
+}
+/**
+ * SDK 的預設 Bearer middleware 會把中文 OAuth 錯誤訊息直接放進 Header，
+ * Node.js 會因此拒絕非 Latin-1 字元。這裡保留中文 JSON 錯誤，Header 使用固定 ASCII 描述。
+ */
+export declare function requireSafeBearerAuth({ verifier, requiredScopes, resourceMetadataUrl, }: SafeBearerAuthOptions): RequestHandler;
+export {};
+//# sourceMappingURL=bearer-auth.d.ts.map

package/dist/transports/bearer-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bearer-auth.d.ts","sourceRoot":"","sources":["../../src/transports/bearer-auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAO9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE/E,OAAO,QAAQ,2BAA2B,CAAC;IACzC,UAAU,OAAO;QACf,IAAI,CAAC,EAAE,QAAQ,CAAC;KACjB;CACF;AAED,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,cAAmB,EACnB,mBAAmB,GACpB,EAAE,qBAAqB,GAAG,cAAc,CAsDxC"}