@critical-path/mcp 0.1.0

package/dist/server/index.js

@@ -0,0 +1,212 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ALL_TOOLS, TOOL_MAP } from '../tools/definitions.js';
+export function createCriticalPathMcpServer(options) {
+    const target = options.engine || options.client;
+    if (!target) {
+        throw new Error('Either engine or client must be provided to createCriticalPathMcpServer.');
+    }
+    const serverName = options.name || 'critical-path-mcp';
+    const serverVersion = options.version || '0.1.0';
+    const activeTools = options.tools
+        ? ALL_TOOLS.filter((t) => options.tools.includes(t.name))
+        : ALL_TOOLS;
+    const server = new Server({
+        name: serverName,
+        version: serverVersion
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {}
+        }
+    });
+    // 1. Tool Listing
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: activeTools.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema
+            }))
+        };
+    });
+    // 2. Tool Execution
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = TOOL_MAP.get(name);
+        if (!tool) {
+            throw new McpError(ErrorCode.MethodNotFound, `Tool "${name}" is not registered on this MCP server.`);
+        }
+        try {
+            const result = await tool.execute(args || {}, target);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error executing tool "${name}": ${err?.message || String(err)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    // 3. Resources Listing
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: [
+                {
+                    uri: 'criticalpath://projects',
+                    name: 'Critical Path Projects',
+                    mimeType: 'application/json',
+                    description: 'Live list of all projects managed by Critical Path'
+                },
+                {
+                    uri: 'criticalpath://tasks',
+                    name: 'Critical Path Tasks',
+                    mimeType: 'application/json',
+                    description: 'Live list of all tasks across projects'
+                }
+            ]
+        };
+    });
+    // 4. Resource Reading
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const uri = request.params.uri;
+        if (uri === 'criticalpath://projects') {
+            const projects = await target.getProjects();
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(projects, null, 2)
+                    }
+                ]
+            };
+        }
+        if (uri === 'criticalpath://tasks') {
+            const tasks = await target.getTasks();
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(tasks, null, 2)
+                    }
+                ]
+            };
+        }
+        const taskMatch = uri.match(/^criticalpath:\/\/tasks\/([^/]+)$/);
+        if (taskMatch) {
+            const taskId = taskMatch[1];
+            const task = await target.getTask(taskId);
+            if (!task) {
+                throw new McpError(ErrorCode.InvalidRequest, `Task with ID "${taskId}" not found.`);
+            }
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(task, null, 2)
+                    }
+                ]
+            };
+        }
+        throw new McpError(ErrorCode.InvalidRequest, `Unknown resource URI: ${uri}`);
+    });
+    // 5. Prompts Listing
+    server.setRequestHandler(ListPromptsRequestSchema, async () => {
+        return {
+            prompts: [
+                {
+                    name: 'summarize_project',
+                    description: 'Analyze project health, open tasks, blockers, and recent deliverables.',
+                    arguments: [
+                        {
+                            name: 'projectId',
+                            description: 'The ID of the project to summarize',
+                            required: true
+                        }
+                    ]
+                },
+                {
+                    name: 'triage_task',
+                    description: 'Review a task description, suggest priority, labels, and workflow status.',
+                    arguments: [
+                        {
+                            name: 'taskId',
+                            description: 'The task ID to triage',
+                            required: true
+                        }
+                    ]
+                }
+            ]
+        };
+    });
+    // 6. Prompts Retrieval
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        if (name === 'summarize_project') {
+            const projectId = args?.projectId;
+            if (!projectId) {
+                throw new McpError(ErrorCode.InvalidParams, 'Argument "projectId" is required.');
+            }
+            const project = await target.getProject(projectId);
+            const tasks = await target.getTasks(projectId);
+            return {
+                description: `Project summary for ${project?.name || projectId}`,
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please analyze the current status of project "${project?.name || projectId}".\n\nProject Info:\n${JSON.stringify(project, null, 2)}\n\nTasks (${tasks.length} total):\n${JSON.stringify(tasks, null, 2)}\n\nProvide an executive summary highlighting:\n1. Overall progress and completion rate\n2. Any high/urgent priority tasks needing immediate attention\n3. Recommendations for unblocking or advancing the sprint.`
+                        }
+                    }
+                ]
+            };
+        }
+        if (name === 'triage_task') {
+            const taskId = args?.taskId;
+            if (!taskId) {
+                throw new McpError(ErrorCode.InvalidParams, 'Argument "taskId" is required.');
+            }
+            const task = await target.getTask(taskId);
+            if (!task) {
+                throw new McpError(ErrorCode.InvalidRequest, `Task "${taskId}" not found.`);
+            }
+            return {
+                description: `Triage task "${task.title}"`,
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please review and triage the following task:\n\n${JSON.stringify(task, null, 2)}\n\nSuggest:\n1. Appropriate priority level\n2. Relevant tags\n3. Estimated completion hours\n4. Clear acceptance criteria or missing details.`
+                        }
+                    }
+                ]
+            };
+        }
+        throw new McpError(ErrorCode.MethodNotFound, `Prompt "${name}" is not defined.`);
+    });
+    return server;
+}
+export async function startStdioServer(server) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

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

package/dist/tools/definitions.d.ts

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import type { CriticalPathEngine } from '@critical-path/core';
+import type { CriticalPathClient } from '@critical-path/client';
+export type BackendContext = CriticalPathEngine | CriticalPathClient;
+export interface ToolDefinition<TParams = any, TResult = any> {
+    name: string;
+    title: string;
+    description: string;
+    zodSchema: z.ZodObject<any>;
+    inputSchema: Record<string, unknown>;
+    annotations?: {
+        readOnlyHint?: boolean;
+        requiresConfirmation?: boolean;
+    };
+    execute: (args: TParams, target: BackendContext, ambientContext?: {
+        projectId?: string;
+    }) => Promise<TResult>;
+}
+export declare function resolveBackend(target: BackendContext): Promise<{
+    isEngine: boolean;
+}>;
+export declare const listProjectsTool: ToolDefinition;
+export declare const getProjectTool: ToolDefinition<{
+    id: string;
+}>;
+export declare const createProjectTool: ToolDefinition<{
+    name: string;
+    description?: string;
+    key?: string;
+}>;
+export declare const listTasksTool: ToolDefinition<{
+    projectId?: string;
+    status?: string;
+    priority?: string;
+    assigneeId?: string;
+}>;
+export declare const getTaskTool: ToolDefinition<{
+    id: string;
+}>;
+export declare const createTaskTool: ToolDefinition<{
+    projectId?: string;
+    title: string;
+    description?: string;
+    status?: string;
+    priority?: 'urgent' | 'high' | 'medium' | 'low' | 'none';
+    assigneeId?: string;
+    dueDate?: string;
+    tags?: string[];
+    estimatedHours?: number;
+}>;
+export declare const updateTaskTool: ToolDefinition<{
+    id: string;
+    title?: string;
+    description?: string;
+    status?: string;
+    priority?: 'urgent' | 'high' | 'medium' | 'low' | 'none';
+    assigneeId?: string;
+    dueDate?: string;
+    tags?: string[];
+    estimatedHours?: number;
+    loggedHours?: number;
+}>;
+export declare const deleteTaskTool: ToolDefinition<{
+    id: string;
+}>;
+export declare const listDeliverablesTool: ToolDefinition<{
+    projectId?: string;
+}>;
+export declare const createDeliverableTool: ToolDefinition<{
+    projectId?: string;
+    title: string;
+    description?: string;
+    dueDate?: string;
+    taskIds?: string[];
+}>;
+export declare const listCommentsTool: ToolDefinition<{
+    taskId: string;
+}>;
+export declare const addCommentTool: ToolDefinition<{
+    taskId: string;
+    content: string;
+    authorId: string;
+}>;
+export declare const ALL_TOOLS: ToolDefinition[];
+export declare const TOOL_MAP: Map<string, ToolDefinition<any, any>>;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/tools/definitions.d.ts.map

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

package/dist/tools/definitions.js

@@ -0,0 +1,360 @@
+import { z } from 'zod';
+// Helper to normalize calling engine vs client
+export async function resolveBackend(target) {
+    const isEngine = 'store' in target && typeof target.store === 'object';
+    return { isEngine };
+}
+export const listProjectsTool = {
+    name: 'list_projects',
+    title: 'List Projects',
+    description: 'Retrieve all projects in the workspace.',
+    zodSchema: z.object({}),
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: async (_args, target) => {
+        return target.getProjects();
+    }
+};
+export const getProjectTool = {
+    name: 'get_project',
+    title: 'Get Project',
+    description: 'Get details of a specific project by its ID.',
+    zodSchema: z.object({
+        id: z.string().describe('The project ID')
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'The project ID' }
+        },
+        required: ['id'],
+        additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: async (args, target) => {
+        return target.getProject(args.id);
+    }
+};
+export const createProjectTool = {
+    name: 'create_project',
+    title: 'Create Project',
+    description: 'Create a new project workspace.',
+    zodSchema: z.object({
+        name: z.string().describe('Name of the project'),
+        description: z.string().optional().describe('Description of the project'),
+        key: z.string().optional().describe('Short project key/prefix (e.g. "PROJ")')
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Name of the project' },
+            description: { type: 'string', description: 'Description of the project' },
+            key: { type: 'string', description: 'Short project key/prefix (e.g. "PROJ")' }
+        },
+        required: ['name'],
+        additionalProperties: false
+    },
+    execute: async (args, target) => {
+        return target.createProject(args);
+    }
+};
+export const listTasksTool = {
+    name: 'list_tasks',
+    title: 'List Tasks',
+    description: 'List tasks, optionally filtered by project, status, priority, or assignee.',
+    zodSchema: z.object({
+        projectId: z.string().optional().describe('Filter by project ID'),
+        status: z.string().optional().describe('Filter by task status key'),
+        priority: z.enum(['urgent', 'high', 'medium', 'low', 'none']).optional().describe('Filter by priority'),
+        assigneeId: z.string().optional().describe('Filter by assignee ID')
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectId: { type: 'string', description: 'Filter by project ID' },
+            status: { type: 'string', description: 'Filter by task status key' },
+            priority: {
+                type: 'string',
+                enum: ['urgent', 'high', 'medium', 'low', 'none'],
+                description: 'Filter by priority'
+            },
+            assigneeId: { type: 'string', description: 'Filter by assignee ID' }
+        },
+        additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: async (args, target, ambientContext) => {
+        const projectId = args.projectId || ambientContext?.projectId;
+        let tasks = await target.getTasks(projectId);
+        if (args.status) {
+            tasks = tasks.filter((t) => t.status === args.status);
+        }
+        if (args.priority) {
+            tasks = tasks.filter((t) => t.priority === args.priority);
+        }
+        if (args.assigneeId) {
+            tasks = tasks.filter((t) => t.assigneeId === args.assigneeId);
+        }
+        return tasks;
+    }
+};
+export const getTaskTool = {
+    name: 'get_task',
+    title: 'Get Task',
+    description: 'Get task details by ID.',
+    zodSchema: z.object({
+        id: z.string().describe('The task ID')
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'The task ID' }
+        },
+        required: ['id'],
+        additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: async (args, target) => {
+        return target.getTask(args.id);
+    }
+};
+export const createTaskTool = {
+    name: 'create_task',
+    title: 'Create Task',
+    description: 'Create a new task within a project.',
+    zodSchema: z.object({
+        projectId: z.string().optional().describe('Project ID (inferred from active view in browser if omitted)'),
+        title: z.string().describe('Title of the task'),
+        description: z.string().optional().describe('Detailed description / markdown'),
+        status: z.string().optional().describe('Status (defaults to "todo" or first workflow status)'),
+        priority: z.enum(['urgent', 'high', 'medium', 'low', 'none']).optional().default('none').describe('Task priority'),
+        assigneeId: z.string().optional().describe('User ID to assign task to'),
+        dueDate: z.string().optional().describe('Due date (ISO string)'),
+        tags: z.array(z.string()).optional().describe('Tags for categorization'),
+        estimatedHours: z.number().optional().describe('Estimated hours to complete')
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectId: { type: 'string', description: 'Project ID (inferred from active view if omitted)' },
+            title: { type: 'string', description: 'Title of the task' },
+            description: { type: 'string', description: 'Detailed description' },
+            status: { type: 'string', description: 'Status key' },
+            priority: { type: 'string', enum: ['urgent', 'high', 'medium', 'low', 'none'] },
+            assigneeId: { type: 'string', description: 'User ID of assignee' },
+            dueDate: { type: 'string', description: 'Due date in ISO 8601 format' },
+            tags: { type: 'array', items: { type: 'string' } },
+            estimatedHours: { type: 'number' }
+        },
+        required: ['title'],
+        additionalProperties: false
+    },
+    execute: async (args, target, ambientContext) => {
+        const projectId = args.projectId || ambientContext?.projectId;
+        if (!projectId) {
+            throw new Error('projectId is required to create a task, but none was provided or active in context.');
+        }
+        const input = {
+            projectId,
+            title: args.title,
+            description: args.description,
+            status: args.status || 'todo',
+            priority: args.priority || 'none',
+            assigneeId: args.assigneeId,
+            dueDate: args.dueDate,
+            tags: args.tags || [],
+            estimatedHours: args.estimatedHours
+        };
+        return target.createTask(input);
+    }
+};
+export const updateTaskTool = {
+    name: 'update_task',
+    title: 'Update Task',
+    description: 'Update fields of an existing task (e.g. title, status, priority, assignee).',
+    zodSchema: z.object({
+        id: z.string().describe('The task ID'),
+        title: z.string().optional(),
+        description: z.string().optional(),
+        status: z.string().optional(),
+        priority: z.enum(['urgent', 'high', 'medium', 'low', 'none']).optional(),
+        assigneeId: z.string().optional(),
+        dueDate: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+        estimatedHours: z.number().optional(),
+        loggedHours: z.number().optional()
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'Task ID' },
+            title: { type: 'string' },
+            description: { type: 'string' },
+            status: { type: 'string' },
+            priority: { type: 'string', enum: ['urgent', 'high', 'medium', 'low', 'none'] },
+            assigneeId: { type: 'string' },
+            dueDate: { type: 'string' },
+            tags: { type: 'array', items: { type: 'string' } },
+            estimatedHours: { type: 'number' },
+            loggedHours: { type: 'number' }
+        },
+        required: ['id'],
+        additionalProperties: false
+    },
+    execute: async (args, target) => {
+        const { id, ...updates } = args;
+        return target.updateTask(id, updates);
+    }
+};
+export const deleteTaskTool = {
+    name: 'delete_task',
+    title: 'Delete Task',
+    description: 'Delete a task by ID.',
+    zodSchema: z.object({
+        id: z.string().describe('The task ID to delete')
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'The task ID' }
+        },
+        required: ['id'],
+        additionalProperties: false
+    },
+    annotations: { requiresConfirmation: true },
+    execute: async (args, target) => {
+        const success = await target.deleteTask(args.id);
+        return { success };
+    }
+};
+export const listDeliverablesTool = {
+    name: 'list_deliverables',
+    title: 'List Deliverables',
+    description: 'List deliverables/milestones for a project.',
+    zodSchema: z.object({
+        projectId: z.string().optional().describe('Project ID')
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectId: { type: 'string', description: 'Project ID' }
+        },
+        additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: async (args, target, ambientContext) => {
+        const projectId = args.projectId || ambientContext?.projectId;
+        if (!projectId)
+            throw new Error('projectId is required to list deliverables.');
+        if ('getDeliverables' in target && typeof target.getDeliverables === 'function') {
+            return target.getDeliverables(projectId);
+        }
+        return [];
+    }
+};
+export const createDeliverableTool = {
+    name: 'create_deliverable',
+    title: 'Create Deliverable',
+    description: 'Create a milestone deliverable within a project.',
+    zodSchema: z.object({
+        projectId: z.string().optional(),
+        title: z.string(),
+        description: z.string().optional(),
+        dueDate: z.string().optional(),
+        taskIds: z.array(z.string()).optional()
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectId: { type: 'string' },
+            title: { type: 'string' },
+            description: { type: 'string' },
+            dueDate: { type: 'string' },
+            taskIds: { type: 'array', items: { type: 'string' } }
+        },
+        required: ['title'],
+        additionalProperties: false
+    },
+    execute: async (args, target, ambientContext) => {
+        const projectId = args.projectId || ambientContext?.projectId;
+        if (!projectId)
+            throw new Error('projectId is required to create a deliverable.');
+        if ('createDeliverable' in target && typeof target.createDeliverable === 'function') {
+            return target.createDeliverable({
+                ...args,
+                projectId
+            });
+        }
+        throw new Error('createDeliverable is not supported by this backend target.');
+    }
+};
+export const listCommentsTool = {
+    name: 'list_comments',
+    title: 'List Comments',
+    description: 'List comments associated with a task.',
+    zodSchema: z.object({
+        taskId: z.string().describe('The task ID')
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            taskId: { type: 'string', description: 'The task ID' }
+        },
+        required: ['taskId'],
+        additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: async (args, target) => {
+        if ('getComments' in target && typeof target.getComments === 'function') {
+            return target.getComments(args.taskId);
+        }
+        return [];
+    }
+};
+export const addCommentTool = {
+    name: 'add_comment',
+    title: 'Add Comment',
+    description: 'Add a comment to a task.',
+    zodSchema: z.object({
+        taskId: z.string().describe('The task ID'),
+        content: z.string().describe('Comment body/markdown'),
+        authorId: z.string().describe('Author user ID')
+    }),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            taskId: { type: 'string', description: 'The task ID' },
+            content: { type: 'string', description: 'Comment body/markdown' },
+            authorId: { type: 'string', description: 'Author user ID' }
+        },
+        required: ['taskId', 'content', 'authorId'],
+        additionalProperties: false
+    },
+    execute: async (args, target) => {
+        return target.addComment({
+            taskId: args.taskId,
+            content: args.content,
+            authorId: args.authorId
+        });
+    }
+};
+export const ALL_TOOLS = [
+    listProjectsTool,
+    getProjectTool,
+    createProjectTool,
+    listTasksTool,
+    getTaskTool,
+    createTaskTool,
+    updateTaskTool,
+    deleteTaskTool,
+    listDeliverablesTool,
+    createDeliverableTool,
+    listCommentsTool,
+    addCommentTool
+];
+export const TOOL_MAP = new Map(ALL_TOOLS.map((tool) => [tool.name, tool]));
+//# sourceMappingURL=definitions.js.map