kaneo-mcp 0.0.0

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "kaneo-mcp",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "kaneo-mcp": "./bin/kaneo-mcp.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --outdir=dist --format=esm --packages=external --external:fs --external:path --external:crypto --external:os --external:util --external:stream --external:buffer --external:events --external:url --external:querystring --external:http --external:https --external:net --external:tls --external:zlib",
+    "lint": "biome check --write .",
+    "test": "vitest run --config vitest.config.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.3.0",
+    "hono": "^4.12.8",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@kaneo/typescript-config": "workspace:*",
+    "esbuild": "^0.27.4",
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.2"
+  }
+}

package/src/client.ts

@@ -0,0 +1,443 @@
+import type { KaneoConfig } from "./types";
+
+export class KaneoClient {
+  private baseUrl: string;
+  private token: string;
+
+  constructor(config: KaneoConfig) {
+    this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+    if (!this.baseUrl.endsWith("/api")) {
+      this.baseUrl = `${this.baseUrl}/api`;
+    }
+    this.token = config.token;
+  }
+
+  private async request<T>(
+    path: string,
+    options: RequestInit = {},
+  ): Promise<T> {
+    const url = `${this.baseUrl}${path}`;
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.token}`,
+      ...(options.headers as Record<string, string>),
+    };
+
+    const response = await fetch(url, {
+      ...options,
+      headers,
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Kaneo API error: ${response.status} ${error}`);
+    }
+
+    return response.json();
+  }
+
+  // Health
+  async health() {
+    return this.request<{ status: string }>("/health");
+  }
+
+  // Config
+  async getConfig() {
+    return this.request<{ public: Record<string, unknown> }>("/config");
+  }
+
+  // Projects
+  async listProjects(workspaceId: string) {
+    return this.request<{ projects: unknown[] }>(
+      `/project?workspaceId=${encodeURIComponent(workspaceId)}`,
+    );
+  }
+
+  async createProject(data: {
+    name: string;
+    description?: string;
+    workspaceId: string;
+  }) {
+    return this.request<{ project: unknown }>("/project", {
+      method: "POST",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async getProject(id: string) {
+    return this.request<{ project: unknown }>(`/project/${id}`);
+  }
+
+  async updateProject(
+    id: string,
+    data: { name?: string; description?: string },
+  ) {
+    return this.request<{ project: unknown }>(`/project/${id}`, {
+      method: "PUT",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async deleteProject(id: string) {
+    return this.request<{ success: boolean }>(`/project/${id}`, {
+      method: "DELETE",
+    });
+  }
+
+  async archiveProject(id: string) {
+    return this.request<{ project: unknown }>(`/project/${id}/archive`, {
+      method: "PUT",
+    });
+  }
+
+  async unarchiveProject(id: string) {
+    return this.request<{ project: unknown }>(`/project/${id}/unarchive`, {
+      method: "PUT",
+    });
+  }
+
+  // Tasks
+  async listTasks(
+    projectId: string,
+    params?: {
+      status?: string;
+      priority?: string;
+      assigneeId?: string;
+    },
+  ) {
+    const query = new URLSearchParams();
+    if (params?.status) query.set("status", params.status);
+    if (params?.priority) query.set("priority", params.priority);
+    if (params?.assigneeId) query.set("assigneeId", params.assigneeId);
+
+    const queryString = query.toString();
+    return this.request<{ tasks: unknown[] }>(
+      `/task/tasks/${projectId}${queryString ? `?${queryString}` : ""}`,
+    );
+  }
+
+  async createTask(
+    projectId: string,
+    data: {
+      title: string;
+      description?: string;
+      status?: string;
+      priority?: string;
+      assigneeId?: string;
+      startDate?: string;
+      dueDate?: string;
+    },
+  ) {
+    return this.request<{ task: unknown }>(`/task/${projectId}`, {
+      method: "POST",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async getTask(id: string) {
+    return this.request<{ task: unknown }>(`/task/${id}`);
+  }
+
+  async updateTask(
+    id: string,
+    data: {
+      title?: string;
+      description?: string;
+      status?: string;
+      priority?: string;
+      assigneeId?: string;
+      startDate?: string;
+      dueDate?: string;
+    },
+  ) {
+    return this.request<{ task: unknown }>(`/task/${id}`, {
+      method: "PUT",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async deleteTask(id: string) {
+    return this.request<{ success: boolean }>(`/task/${id}`, {
+      method: "DELETE",
+    });
+  }
+
+  async updateTaskStatus(id: string, status: string) {
+    return this.request<{ task: unknown }>(`/task/status/${id}`, {
+      method: "PUT",
+      body: JSON.stringify({ status }),
+    });
+  }
+
+  async updateTaskPriority(id: string, priority: string) {
+    return this.request<{ task: unknown }>(`/task/priority/${id}`, {
+      method: "PUT",
+      body: JSON.stringify({ priority }),
+    });
+  }
+
+  async updateTaskAssignee(id: string, userId: string | null) {
+    return this.request<{ task: unknown }>(`/task/assignee/${id}`, {
+      method: "PUT",
+      body: JSON.stringify({ userId }),
+    });
+  }
+
+  async updateTaskDueDate(id: string, dueDate: string | null) {
+    return this.request<{ task: unknown }>(`/task/due-date/${id}`, {
+      method: "PUT",
+      body: JSON.stringify({ dueDate }),
+    });
+  }
+
+  async updateTaskTitle(id: string, title: string) {
+    return this.request<{ task: unknown }>(`/task/title/${id}`, {
+      method: "PUT",
+      body: JSON.stringify({ title }),
+    });
+  }
+
+  async updateTaskDescription(id: string, description: string) {
+    return this.request<{ task: unknown }>(`/task/description/${id}`, {
+      method: "PUT",
+      body: JSON.stringify({ description }),
+    });
+  }
+
+  async moveTask(id: string, projectId: string) {
+    return this.request<{ task: unknown }>(`/task/move/${id}`, {
+      method: "PUT",
+      body: JSON.stringify({ projectId }),
+    });
+  }
+
+  // Columns
+  async listColumns(projectId: string) {
+    return this.request<{ columns: unknown[] }>(`/column/${projectId}`);
+  }
+
+  async createColumn(
+    projectId: string,
+    data: { name: string; order?: number },
+  ) {
+    return this.request<{ column: unknown }>(`/column/${projectId}`, {
+      method: "POST",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async updateColumn(id: string, data: { name?: string; order?: number }) {
+    return this.request<{ column: unknown }>(`/column/${id}`, {
+      method: "PUT",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async deleteColumn(id: string) {
+    return this.request<{ success: boolean }>(`/column/${id}`, {
+      method: "DELETE",
+    });
+  }
+
+  async reorderColumns(projectId: string, columnIds: string[]) {
+    return this.request<{ columns: unknown[] }>(
+      `/column/reorder/${projectId}`,
+      {
+        method: "PUT",
+        body: JSON.stringify({ columnIds }),
+      },
+    );
+  }
+
+  // Comments
+  async listComments(taskId: string) {
+    return this.request<{ comments: unknown[] }>(`/comment/${taskId}`);
+  }
+
+  async createComment(taskId: string, content: string) {
+    return this.request<{ comment: unknown }>(`/comment/${taskId}`, {
+      method: "POST",
+      body: JSON.stringify({ content }),
+    });
+  }
+
+  async updateComment(id: string, content: string) {
+    return this.request<{ comment: unknown }>(`/comment/${id}`, {
+      method: "PUT",
+      body: JSON.stringify({ content }),
+    });
+  }
+
+  async deleteComment(id: string) {
+    return this.request<{ success: boolean }>(`/comment/${id}`, {
+      method: "DELETE",
+    });
+  }
+
+  // Labels
+  async listLabelsForTask(taskId: string) {
+    return this.request<{ labels: unknown[] }>(`/label/task/${taskId}`);
+  }
+
+  async listWorkspaceLabels(workspaceId: string) {
+    return this.request<{ labels: unknown[] }>(
+      `/label/workspace/${workspaceId}`,
+    );
+  }
+
+  async createLabel(data: {
+    name: string;
+    color: string;
+    workspaceId: string;
+  }) {
+    return this.request<{ label: unknown }>("/label", {
+      method: "POST",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async getLabel(id: string) {
+    return this.request<{ label: unknown }>(`/label/${id}`);
+  }
+
+  async updateLabel(id: string, data: { name?: string; color?: string }) {
+    return this.request<{ label: unknown }>(`/label/${id}`, {
+      method: "PUT",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async deleteLabel(id: string) {
+    return this.request<{ success: boolean }>(`/label/${id}`, {
+      method: "DELETE",
+    });
+  }
+
+  async attachLabelToTask(labelId: string, taskId: string) {
+    return this.request<{ success: boolean }>(`/label/${labelId}/task`, {
+      method: "PUT",
+      body: JSON.stringify({ taskId }),
+    });
+  }
+
+  async detachLabelFromTask(labelId: string, taskId: string) {
+    return this.request<{ success: boolean }>(`/label/${labelId}/task`, {
+      method: "DELETE",
+      body: JSON.stringify({ taskId }),
+    });
+  }
+
+  // Time Entries
+  async listTimeEntries(taskId: string) {
+    return this.request<{ timeEntries: unknown[] }>(
+      `/time-entry/task/${taskId}`,
+    );
+  }
+
+  async getTimeEntry(id: string) {
+    return this.request<{ timeEntry: unknown }>(`/time-entry/${id}`);
+  }
+
+  async createTimeEntry(data: {
+    taskId: string;
+    duration: number;
+    description?: string;
+  }) {
+    return this.request<{ timeEntry: unknown }>("/time-entry", {
+      method: "POST",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async updateTimeEntry(
+    id: string,
+    data: { duration?: number; description?: string },
+  ) {
+    return this.request<{ timeEntry: unknown }>(`/time-entry/${id}`, {
+      method: "PUT",
+      body: JSON.stringify(data),
+    });
+  }
+
+  // Task Relations
+  async listTaskRelations(taskId: string) {
+    return this.request<{ relations: unknown[] }>(`/task-relation/${taskId}`);
+  }
+
+  async createTaskRelation(data: {
+    taskId: string;
+    relatedTaskId: string;
+    type: "subtask" | "blocks" | "related";
+  }) {
+    return this.request<{ relation: unknown }>("/task-relation", {
+      method: "POST",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async deleteTaskRelation(id: string) {
+    return this.request<{ success: boolean }>(`/task-relation/${id}`, {
+      method: "DELETE",
+    });
+  }
+
+  // Notifications
+  async listNotifications() {
+    return this.request<{ notifications: unknown[] }>("/notification");
+  }
+
+  async markNotificationRead(id: string) {
+    return this.request<{ notification: unknown }>(`/notification/${id}/read`, {
+      method: "PATCH",
+    });
+  }
+
+  async markAllNotificationsRead() {
+    return this.request<{ success: boolean }>("/notification/read-all", {
+      method: "PATCH",
+    });
+  }
+
+  async clearAllNotifications() {
+    return this.request<{ success: boolean }>("/notification/clear-all", {
+      method: "DELETE",
+    });
+  }
+
+  // Workspace
+  async listWorkspaceMembers(workspaceId: string) {
+    return this.request<{ members: unknown[] }>(
+      `/workspace/${workspaceId}/members`,
+    );
+  }
+
+  // Search
+  async search(
+    query: string,
+    type?:
+      | "all"
+      | "tasks"
+      | "projects"
+      | "workspaces"
+      | "comments"
+      | "activities",
+  ) {
+    const params = new URLSearchParams({ q: query });
+    if (type) params.set("type", type);
+    return this.request<{ results: unknown[] }>(`/search?${params.toString()}`);
+  }
+
+  // Activity
+  async listActivities(taskId: string) {
+    return this.request<{ activities: unknown[] }>(`/activity/${taskId}`);
+  }
+
+  // Invitations
+  async listPendingInvitations() {
+    return this.request<{ invitations: unknown[] }>("/invitation/pending");
+  }
+
+  async getInvitation(id: string) {
+    return this.request<{ invitation: unknown }>(`/invitation/${id}`);
+  }
+}