Dooray MCP Server

Instructions

Implementation Reference

• src/tools/projects/get-project-workflow-list.ts:17-45 (handler)

  The main handler function that implements the tool logic: fetches project workflows via API, filters and compacts the result to reduce tokens, returns JSON string or formatted error.

  export async function getProjectWorkflowListHandler(args: GetProjectWorkflowListInput) {
    try {
      const result = await projectsApi.getProjectWorkflows({
        projectId: args.projectId,
      });
  
      // Filter to compact response to reduce token usage
      const compactResult = result.map(filterWorkflowForList);
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(compactResult, null, 2),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error: ${formatError(error)}`,
          },
        ],
        isError: true,
      };
    }
  }

• src/tools/projects/get-project-workflow-list.ts:11-16 (schema)

  Zod schema defining the input: projectId as string. Used for runtime validation in the server. Type inferred for handler args.

  export const getProjectWorkflowListSchema = z.object({
    projectId: z.string().describe('Project ID to get workflows from'),
  });
  
  export type GetProjectWorkflowListInput = z.infer<typeof getProjectWorkflowListSchema>;

• src/tools/projects/get-project-workflow-list.ts:47-76 (registration)

  Tool metadata object with name, detailed description, and JSON inputSchema for MCP list_tools response.

  export const getProjectWorkflowListTool = {
    name: 'get-project-workflow-list',
    description: `Get list of workflow statuses (업무 상태) for a project.
  
  Workflows represent the task statuses available in a project. There are four workflow classes:
  - backlog: 대기 (waiting/backlog)
  - registered: 등록/할 일 (registered/to-do)
  - working: 진행 중 (in progress)
  - closed: 완료 (completed/done)
  
  Each project may have custom workflows within these classes. Use workflow IDs when creating or updating tasks (e.g., in create-task or update-task tools).
  
  **URL Pattern Recognition**:
  When given a Dooray URL like "https://nhnent.dooray.com/task/PROJECT_ID", extract the PROJECT_ID (the numeric ID after "/task/") and use it as the projectId parameter.
  
  Examples:
  - Get all workflows: {"projectId": "1769381697328002548"}
  
  Returns: Array of workflows with id, name, order, and class.`,
    inputSchema: {
      type: 'object',
      properties: {
        projectId: {
          type: 'string',
          description: 'Project ID to get workflow statuses from',
        },
      },
      required: ['projectId'],
    },
  };

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

  Registers the tool's handler and Zod schema in the central toolRegistry map used by the MCP server for handling tool calls.

  'get-project-workflow-list': { handler: getProjectWorkflowListHandler, schema: getProjectWorkflowListSchema },

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

  Adds the tool metadata to the tools array returned in MCP list_tools requests.

  getProjectWorkflowListTool,