Dooray MCP Server

Instructions

Implementation Reference

• src/tools/projects/get-task-comment-list.ts:21-40 (handler)

  The main handler function executing the tool: fetches task comments via API, filters paginated response, stringifies and returns as text content.

  export async function getTaskCommentListHandler(args: GetTaskCommentListInput) {
    try {
      const result = await projectsApi.getTaskComments({
        projectId: args.projectId,
        taskId: args.taskId,
        page: args.page,
        size: args.size,
        order: args.order,
      });
  
      // Filter response to reduce token usage
      const filtered = filterPaginatedResponse(result, filterTaskCommentForList);
  
      return {
        content: [{ type: 'text', text: JSON.stringify(filtered, null, 2) }],
      };
    } catch (error) {
      return formatError(error);
    }
  }

• src/tools/projects/get-task-comment-list.ts:11-17 (schema)

  Zod schema defining and validating the input parameters for the tool.

  export const getTaskCommentListSchema = z.object({
    projectId: z.string().describe('Project ID where the task belongs'),
    taskId: z.string().describe('Task ID to get comments from'),
    page: z.number().min(0).optional().describe('Page number (default: 0)'),
    size: z.number().min(1).max(100).optional().describe('Items per page (default: 20, max: 100)'),
    order: z.enum(['createdAt', '-createdAt']).optional().describe('Sort order: createdAt (oldest first, default), -createdAt (newest first)'),
  });

• src/index.ts:55-55 (registration)

  Registration in the central toolRegistry mapping the tool name to its handler and schema for dynamic tool dispatch.

  'get-task-comment-list': { handler: getTaskCommentListHandler, schema: getTaskCommentListSchema },

• src/index.ts:78-78 (registration)

  Inclusion of the tool descriptor in the tools array returned by the listTools MCP request.

  getTaskCommentListTool,

• src/tools/projects/get-task-comment-list.ts:42-105 (helper)

  Tool descriptor object with name, detailed description, and input schema used for MCP tool listing and discovery.

  export const getTaskCommentListTool = {
    name: 'get-task-comment-list',
    description: `Get list of comments (댓글) on a specific Dooray task.
  
  This tool fetches all comments that have been added to a task. Comments are discussions, updates, or notes added by team members.
  
  **URL Pattern Recognition**:
  When given a Dooray task URL like "https://nhnent.dooray.com/task/PROJECT_ID/TASK_ID" or "https://nhnent.dooray.com/project/tasks/TASK_ID":
  - Extract the first numeric ID after "/task/" as projectId (if present)
  - Extract the second numeric ID (or the ID after "/tasks/") as taskId
  
  **IMPORTANT**: Both projectId and taskId are REQUIRED.
  
  **Pagination**:
  - Default page size is 20 (maximum: 100)
  - Use page parameter to get additional pages if totalCount > size
  
  **Sorting**:
  - Default: createdAt (oldest comments first)
  - Use "-createdAt" to get newest comments first
  
  **Note**: Returns filtered response with essential fields only (id, creator, body).
  
  Examples:
  - Get all comments (first page): {"projectId": "123456", "taskId": "789012"}
  - Get newest comments first: {"projectId": "123456", "taskId": "789012", "order": "-createdAt"}
  - Get second page: {"projectId": "123456", "taskId": "789012", "page": 1, "size": 20}
  
  Returns a paginated response with totalCount and array of comments containing:
  - **id**: Comment ID
  - **creator**: Who wrote the comment (member or emailUser)
    - For members: {"type": "member", "member": {"organizationMemberId": "..."}}
    - For email users: {"type": "emailUser", "emailUser": {"emailAddress": "...", "name": "..."}}
  - **body**: Comment content with mimeType and content
  
  Use this tool to view discussion history, progress updates, or notes on a task.`,
    inputSchema: {
      type: 'object',
      properties: {
        projectId: {
          type: 'string',
          description: 'Project ID where the task belongs',
        },
        taskId: {
          type: 'string',
          description: 'Task ID to get comments from',
        },
        page: {
          type: 'number',
          description: 'Page number (default: 0)',
        },
        size: {
          type: 'number',
          description: 'Items per page (default: 20, max: 100)',
        },
        order: {
          type: 'string',
          enum: ['createdAt', '-createdAt'],
          description: 'Sort order: createdAt (oldest first, default), -createdAt (newest first)',
        },
      },
      required: ['projectId', 'taskId'],
    },
  };