PingCode MCP Server

Instructions

Implementation Reference

• src/tools/work-items.ts:618-657 (handler)

  The handler function that fetches and formats the list of releases for a given project ID using pingcodeClient.

  export async function listReleases(
    projectId: string
  ): Promise<{
    success: boolean;
    data?: string;
    error?: string;
  }> {
    try {
      const releases = await pingcodeClient.getProjectReleases(projectId);
  
      if (releases.length === 0) {
        return {
          success: true,
          data: '该项目没有发布版本',
        };
      }
  
      const lines: string[] = [
        `# ${projectId} 项目发布版本列表`,
        '',
        `共 ${releases.length} 个版本`,
        '',
      ];
  
      releases.forEach((release: any) => {
        const status = release.state === 1 ? '进行中' : release.state === 2 ? '已发布' : '';
        lines.push(`- **${release.name}** (ID: ${release._id}) ${status}`);
      });
  
      return {
        success: true,
        data: lines.join('\n'),
      };
    } catch (error: any) {
      return {
        success: false,
        error: error.message,
      };
    }
  }

• src/index.ts:115-128 (schema)

  Input schema definition for the 'list_releases' tool, specifying the required 'project_id' parameter.

  {
    name: 'list_releases',
    description: '列出项目的所有发布版本。用户可以通过此工具查看版本名称和对应的 ID。',
    inputSchema: {
      type: 'object',
      properties: {
        project_id: {
          type: 'string',
          description: '项目标识，如 LFY（优点云）',
        },
      },
      required: ['project_id'],
    },
  },

• src/index.ts:271-283 (registration)

  Registration and dispatching logic in the tool call handler switch statement, which invokes the listReleases function.

  case 'list_releases': {
    const { project_id } = args as { project_id: string };
    const result = await listReleases(project_id);
    return {
      content: [
        {
          type: 'text',
          text: result.success ? result.data! : `错误: ${result.error}`,
        },
      ],
      isError: !result.success,
    };
  }