@jhl8041/dooray-mcp 0.1.0

package/dist/utils/response-filters.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Response Filtering Utilities
+ * Functions to filter API responses to return only essential fields
+ * This reduces token usage when returning list responses to LLMs
+ */
+import { Task, Project, Milestone, Tag, Workflow, ProjectTemplate, ProjectMemberGroup, TaskComment, PaginatedResponse } from '../types/dooray-api.js';
+/**
+ * Filter Task object to return only essential fields for list display
+ */
+export declare function filterTaskForList(task: Task): {
+    id: string;
+    number: number;
+    subject: string;
+    workflowClass: string;
+    priority: "highest" | "high" | "normal" | "low" | "lowest" | "none";
+    milestone: {
+        id: string;
+        name: string;
+    } | undefined;
+    tags: {
+        id: string;
+        name?: string;
+    }[] | undefined;
+    createdAt: string;
+    updatedAt: string;
+};
+/**
+ * Filter Project object to return only essential fields for list display
+ */
+export declare function filterProjectForList(project: Project): {
+    id: string;
+    name: string;
+};
+/**
+ * Filter Milestone object to return only essential fields for list display
+ */
+export declare function filterMilestoneForList(milestone: Milestone): {
+    id: string;
+    name: string;
+    status: "open" | "closed";
+    startedAt: string | undefined;
+    endedAt: string | undefined;
+    createdAt: string;
+};
+/**
+ * Filter Tag object to return only essential fields for list display
+ */
+export declare function filterTagForList(tag: Tag): {
+    id: string;
+    name: string;
+    tagGroup: {
+        id: string;
+        name: string;
+        mandatory?: boolean;
+        selectOne?: boolean;
+    } | undefined;
+};
+/**
+ * Group tags by their tagGroup for more organized display
+ * Returns tagGroups with their associated tags nested inside
+ * Tags without a tagGroup are placed in an "Ungrouped" category
+ */
+export declare function groupTagsByTagGroup(tags: Tag[]): {
+    tagGroups: {
+        id: string | null;
+        name: string;
+        mandatory: boolean;
+        selectOne: boolean;
+        tags: Array<{
+            id: string;
+            name: string;
+        }>;
+    }[];
+};
+/**
+ * Filter Workflow object to return only essential fields for list display
+ * Returns: id, name, order, class
+ * Excludes: names array (localized names), projectId
+ */
+export declare function filterWorkflowForList(workflow: Workflow): {
+    id: string;
+    name: string;
+    order: number;
+    class: "closed" | "backlog" | "registered" | "working";
+};
+/**
+ * Filter ProjectTemplate object to return only essential fields for list display
+ */
+export declare function filterTemplateForList(template: ProjectTemplate): {
+    id: string;
+    templateName: string;
+};
+/**
+ * Filter ProjectMemberGroup object to return only essential fields for list display
+ */
+export declare function filterMemberGroupForList(group: ProjectMemberGroup): {
+    id: string;
+    name: string;
+};
+/**
+ * Filter TaskComment object to return only essential fields
+ * Returns: id, creator, body
+ * Excludes: type, subtype, createdAt, modifiedAt, mailUsers, post
+ */
+export declare function filterTaskCommentForList(comment: TaskComment): {
+    id: string;
+    creator: import("../types/dooray-api.js").TaskCommentCreator;
+    body: {
+        mimeType: string;
+        content: string;
+    };
+};
+/**
+ * Filter paginated response by applying a filter function to each item in data array
+ * Preserves pagination metadata (totalCount)
+ */
+export declare function filterPaginatedResponse<T, F>(response: PaginatedResponse<T>, filterFn: (item: T) => F): {
+    totalCount: number;
+    data: F[];
+};
+//# sourceMappingURL=response-filters.d.ts.map

package/dist/utils/response-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-filters.d.ts","sourceRoot":"","sources":["../../src/utils/response-filters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEtJ;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI;;;;;;;;;;;;;;;;EAY3C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO;;;EAKpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS;;;;;;;EAS1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG;;;;;;;;;EAMxC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE;;YAGvC,MAAM,GAAG,IAAI;cACX,MAAM;mBACD,OAAO;mBACP,OAAO;cACZ,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;;EA6C5C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ;;;;;EAOvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe;;;EAK9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB;;;EAKjE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW;;;;;;;EAM5D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAC1C,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GACvB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,EAAE,CAAA;CAAE,CAKnC"}

package/dist/utils/response-filters.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Response Filtering Utilities
+ * Functions to filter API responses to return only essential fields
+ * This reduces token usage when returning list responses to LLMs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterTaskForList = filterTaskForList;
+exports.filterProjectForList = filterProjectForList;
+exports.filterMilestoneForList = filterMilestoneForList;
+exports.filterTagForList = filterTagForList;
+exports.groupTagsByTagGroup = groupTagsByTagGroup;
+exports.filterWorkflowForList = filterWorkflowForList;
+exports.filterTemplateForList = filterTemplateForList;
+exports.filterMemberGroupForList = filterMemberGroupForList;
+exports.filterTaskCommentForList = filterTaskCommentForList;
+exports.filterPaginatedResponse = filterPaginatedResponse;
+/**
+ * Filter Task object to return only essential fields for list display
+ */
+function filterTaskForList(task) {
+    return {
+        id: task.id,
+        number: task.number,
+        subject: task.subject,
+        workflowClass: task.workflowClass,
+        priority: task.priority,
+        milestone: task.milestone,
+        tags: task.tags,
+        createdAt: task.createdAt,
+        updatedAt: task.updatedAt,
+    };
+}
+/**
+ * Filter Project object to return only essential fields for list display
+ */
+function filterProjectForList(project) {
+    return {
+        id: project.id,
+        name: project.code, // 'code' field is actually the project name
+    };
+}
+/**
+ * Filter Milestone object to return only essential fields for list display
+ */
+function filterMilestoneForList(milestone) {
+    return {
+        id: milestone.id,
+        name: milestone.name,
+        status: milestone.status,
+        startedAt: milestone.startedAt,
+        endedAt: milestone.endedAt,
+        createdAt: milestone.createdAt,
+    };
+}
+/**
+ * Filter Tag object to return only essential fields for list display
+ */
+function filterTagForList(tag) {
+    return {
+        id: tag.id,
+        name: tag.name,
+        tagGroup: tag.tagGroup,
+    };
+}
+/**
+ * Group tags by their tagGroup for more organized display
+ * Returns tagGroups with their associated tags nested inside
+ * Tags without a tagGroup are placed in an "Ungrouped" category
+ */
+function groupTagsByTagGroup(tags) {
+    // Group tags by tagGroup.id
+    const groupMap = new Map();
+    for (const tag of tags) {
+        if (tag.tagGroup) {
+            const groupId = tag.tagGroup.id;
+            if (!groupMap.has(groupId)) {
+                groupMap.set(groupId, {
+                    id: groupId,
+                    name: tag.tagGroup.name,
+                    mandatory: tag.tagGroup.mandatory || false,
+                    selectOne: tag.tagGroup.selectOne || false,
+                    tags: [],
+                });
+            }
+            groupMap.get(groupId).tags.push({
+                id: tag.id,
+                name: tag.name,
+            });
+        }
+        else {
+            // Handle tags without tagGroup
+            const ungroupedKey = '__ungrouped__';
+            if (!groupMap.has(ungroupedKey)) {
+                groupMap.set(ungroupedKey, {
+                    id: null,
+                    name: 'Ungrouped',
+                    mandatory: false,
+                    selectOne: false,
+                    tags: [],
+                });
+            }
+            groupMap.get(ungroupedKey).tags.push({
+                id: tag.id,
+                name: tag.name,
+            });
+        }
+    }
+    return {
+        tagGroups: Array.from(groupMap.values()),
+    };
+}
+/**
+ * Filter Workflow object to return only essential fields for list display
+ * Returns: id, name, order, class
+ * Excludes: names array (localized names), projectId
+ */
+function filterWorkflowForList(workflow) {
+    return {
+        id: workflow.id,
+        name: workflow.name,
+        order: workflow.order,
+        class: workflow.class,
+    };
+}
+/**
+ * Filter ProjectTemplate object to return only essential fields for list display
+ */
+function filterTemplateForList(template) {
+    return {
+        id: template.id,
+        templateName: template.templateName,
+    };
+}
+/**
+ * Filter ProjectMemberGroup object to return only essential fields for list display
+ */
+function filterMemberGroupForList(group) {
+    return {
+        id: group.id,
+        name: group.code,
+    };
+}
+/**
+ * Filter TaskComment object to return only essential fields
+ * Returns: id, creator, body
+ * Excludes: type, subtype, createdAt, modifiedAt, mailUsers, post
+ */
+function filterTaskCommentForList(comment) {
+    return {
+        id: comment.id,
+        creator: comment.creator,
+        body: comment.body,
+    };
+}
+/**
+ * Filter paginated response by applying a filter function to each item in data array
+ * Preserves pagination metadata (totalCount)
+ */
+function filterPaginatedResponse(response, filterFn) {
+    return {
+        totalCount: response.totalCount,
+        data: (response.data || []).map(filterFn),
+    };
+}
+//# sourceMappingURL=response-filters.js.map

package/dist/utils/response-filters.js.map

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

package/dooray-mcp.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="GENERAL_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@jhl8041/dooray-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Dooray",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "dooray-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepare": "npm run build",
+    "watch": "tsc --watch"
+  },
+  "keywords": [
+    "dooray-mcp",
+    "dooray mcp",
+    "dooray",
+    "mcp",
+    "model-context-protocol",
+    "nhn",
+    "nhn cloud",
+    "ai",
+    "llm"
+  ],
+  "author": "Jae Hyung Lee",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jhl8041/dooray-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jhl8041/dooray-mcp/issues"
+  },
+  "homepage": "https://github.com/jhl8041/dooray-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "axios": "^1.7.9",
+    "dotenv": "^16.4.7",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}