@opentask/taskin-task-server-mcp 0.1.1

package/README.md

@@ -0,0 +1,119 @@
+# @opentask/taskin-mcp
+
+Model Context Protocol (MCP) server for task management integration with LLMs like Claude, GPT-4, and GitHub Copilot.
+
+## Features
+
+- ✅ Full MCP protocol implementation
+- ✅ Exposes task operations as MCP tools
+- ✅ Task context via MCP resources
+- ✅ Task templates via MCP prompts
+- ✅ Real-time task updates
+- ✅ TypeScript support
+- ✅ Auto-discovery in VS Code and Claude Desktop
+
+## Quick Start
+
+### VS Code (GitHub Copilot)
+
+The server will appear automatically in VS Code's MCP server list after installation:
+
+```bash
+npm install -g @opentask/taskin-mcp
+```
+
+Then in VS Code:
+
+1. Open Command Palette (`Cmd+Shift+P`)
+2. Search for "Configure Tools"
+3. Find "taskin" in the MCP servers list
+4. Enable it
+
+Or add manually to your `settings.json`:
+
+```json
+{
+  "github.copilot.chat.mcpServers": {
+    "taskin": {
+      "command": "taskin-mcp-server"
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "taskin": {
+      "args": ["-y", "@opentask/taskin-task-server-mcp"],
+      "command": "npx"
+    }
+  }
+}
+```
+
+## Installation
+
+### Global (Recommended)
+
+```bash
+npm install -g @opentask/taskin-mcp
+```
+
+### Project-specific
+
+```bash
+pnpm add @opentask/taskin-mcp
+```
+
+## Programmatic Usage
+
+```typescript
+import { createTaskManager } from '@opentask/taskin-task-manager';
+import { createTaskMCPServer } from '@opentask/taskin-task-server-mcp';
+
+// Create task manager with your provider
+const taskManager = createTaskManager({
+  provider: 'fs',
+  config: { tasksDirectory: './TASKS' },
+});
+
+// Start MCP server
+const server = createTaskMCPServer(taskManager, {
+  name: 'taskin-server',
+  version: '1.0.0',
+});
+
+await server.connect({
+  transport: 'stdio', // or 'sse'
+});
+
+console.log('MCP server running');
+```
+
+## MCP Tools
+
+- `list_tasks` - List all tasks with filters
+- `get_task` - Get task details
+- `start_task` - Start working on a task
+- `finish_task` - Mark task as complete
+- `pause_task` - Pause task work
+- `lint_tasks` - Validate tasks
+
+## MCP Resources
+
+- `task://{taskId}` - Get full task context
+- `tasks://status/{status}` - Get tasks by status
+
+## MCP Prompts
+
+- `start-task` - Template for starting a task
+- `review-task` - Template for reviewing a task
+
+## License
+
+MIT © [OpenTask](https://opentask.com.br)

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './task-server-mcp.js';
+export * from './task-server-mcp.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './task-server-mcp.js';
+export * from './task-server-mcp.types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}

package/dist/task-server-mcp.d.ts

@@ -0,0 +1,83 @@
+import type { ITaskManager } from '@opentask/taskin-task-manager';
+import type { ITaskMCPServer, MCPConnectionOptions, MCPPrompt, MCPPromptGetParams, MCPPromptGetResult, MCPResourceListResult, MCPResourceReadParams, MCPServerConfig, MCPTool, MCPToolCallParams, MCPToolCallResult } from './task-server-mcp.types.js';
+/**
+ * MCP Server for task management integration with LLMs
+ */
+export declare class TaskMCPServer implements ITaskMCPServer {
+    private server;
+    private taskManager;
+    private config;
+    constructor(config: MCPServerConfig);
+    /**
+     * Setup MCP request handlers
+     */
+    private setupHandlers;
+    /**
+     * Connect to MCP transport
+     */
+    connect(options: MCPConnectionOptions): Promise<void>;
+    /**
+     * Get server information
+     */
+    getServerInfo(): {
+        name: string;
+        version: string;
+        protocolVersion: string;
+        capabilities: {
+            tools: {};
+            prompts: {};
+            resources: {};
+        };
+    };
+    /**
+     * List available tools
+     */
+    listTools(): {
+        tools: MCPTool[];
+    };
+    /**
+     * Call a tool
+     */
+    callTool(params: MCPToolCallParams): Promise<MCPToolCallResult>;
+    /**
+     * Handle start_task tool
+     */
+    private handleStartTask;
+    /**
+     * Handle finish_task tool
+     */
+    private handleFinishTask;
+    /**
+     * List available prompts
+     */
+    listPrompts(): {
+        prompts: MCPPrompt[];
+    };
+    /**
+     * Get a prompt
+     */
+    getPrompt(params: MCPPromptGetParams): Promise<MCPPromptGetResult>;
+    /**
+     * List available resources
+     */
+    listResources(): Promise<MCPResourceListResult>;
+    /**
+     * Read a resource
+     */
+    readResource(params: MCPResourceReadParams): Promise<{
+        contents: {
+            uri: string;
+            mimeType: string;
+            text: string;
+        }[];
+    }>;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+/**
+ * Create and connect a MCP server for task management
+ */
+export declare function createTaskMCPServer(taskManager: ITaskManager, options?: Partial<MCPServerConfig>): Promise<TaskMCPServer>;
+//# sourceMappingURL=task-server-mcp.d.ts.map

package/dist/task-server-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-server-mcp.d.ts","sourceRoot":"","sources":["../src/task-server-mcp.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,eAAe;IA4BnC;;OAEG;IACH,OAAO,CAAC,aAAa;IAsErB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D;;OAEG;IACH,aAAa;;;;;;;;;;IAab;;OAEG;IACH,SAAS,IAAI;QAAE,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE;IAoCjC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IAsCxC;;OAEG;YACW,eAAe;IA0B7B;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;IACH,WAAW,IAAI;QAAE,OAAO,EAAE,SAAS,EAAE,CAAA;KAAE;IA2CvC;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsFxE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAerD;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,qBAAqB;;;;;;;IAyBhD;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,YAAY,EACzB,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACjC,OAAO,CAAC,aAAa,CAAC,CAUxB"}

package/dist/task-server-mcp.js

@@ -0,0 +1,427 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * MCP Server for task management integration with LLMs
+ */
+export class TaskMCPServer {
+    server;
+    taskManager;
+    config;
+    constructor(config) {
+        this.taskManager = config.taskManager;
+        this.config = {
+            name: 'taskin-mcp-server',
+            version: '1.0.0',
+            debug: false,
+            ...config,
+            taskManager: config.taskManager,
+        };
+        // Initialize MCP Server
+        this.server = new Server({
+            name: this.config.name,
+            version: this.config.version,
+        }, {
+            capabilities: {
+                tools: {},
+                prompts: {},
+                resources: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    /**
+     * Setup MCP request handlers
+     */
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const { tools } = this.listTools();
+            return { tools };
+        });
+        // Call a tool
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const result = await this.callTool({
+                name: request.params.name,
+                arguments: request.params.arguments,
+            });
+            // MCP SDK expects a content array
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: result.content,
+                    },
+                ],
+                isError: result.isError,
+            };
+        });
+        // List available prompts
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+            const { prompts } = this.listPrompts();
+            return { prompts };
+        });
+        // Get a prompt
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const result = await this.getPrompt({
+                name: request.params.name,
+                arguments: request.params.arguments,
+            });
+            // MCP SDK expects a messages array
+            return {
+                messages: result.messages.map((msg) => ({
+                    role: msg.role,
+                    content: {
+                        type: 'text',
+                        text: msg.content,
+                    },
+                })),
+            };
+        });
+        // List available resources
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            const result = await this.listResources();
+            return { resources: result.resources };
+        });
+        // Read a resource
+        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const result = await this.readResource({
+                uri: request.params.uri,
+            });
+            return result;
+        });
+    }
+    /**
+     * Connect to MCP transport
+     */
+    async connect(options) {
+        if (options.transport === 'stdio') {
+            const transport = new StdioServerTransport();
+            await this.server.connect(transport);
+            this.log('MCP Server connected via stdio');
+        }
+        else {
+            throw new Error(`Transport ${options.transport} not yet implemented`);
+        }
+    }
+    /**
+     * Get server information
+     */
+    getServerInfo() {
+        return {
+            name: this.config.name,
+            version: this.config.version,
+            protocolVersion: '2024-11-05',
+            capabilities: {
+                tools: {},
+                prompts: {},
+                resources: {},
+            },
+        };
+    }
+    /**
+     * List available tools
+     */
+    listTools() {
+        const tools = [
+            {
+                name: 'start_task',
+                description: 'Start working on a task by changing its status to in-progress',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        taskId: {
+                            type: 'string',
+                            description: 'The unique identifier of the task (UUID)',
+                        },
+                    },
+                    required: ['taskId'],
+                },
+            },
+            {
+                name: 'finish_task',
+                description: 'Mark a task as completed by changing its status to done',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        taskId: {
+                            type: 'string',
+                            description: 'The unique identifier of the task (UUID)',
+                        },
+                    },
+                    required: ['taskId'],
+                },
+            },
+        ];
+        return { tools };
+    }
+    /**
+     * Call a tool
+     */
+    async callTool(params) {
+        try {
+            this.log(`Calling tool: ${params.name}`, params.arguments);
+            switch (params.name) {
+                case 'start_task':
+                    return await this.handleStartTask(params.arguments?.taskId);
+                case 'finish_task':
+                    return await this.handleFinishTask(params.arguments?.taskId);
+                default:
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Unknown tool: ${params.name}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+            }
+        }
+        catch (error) {
+            this.log('Tool call error:', error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: error instanceof Error ? error.message : String(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    /**
+     * Handle start_task tool
+     */
+    async handleStartTask(taskId) {
+        const task = await this.taskManager.startTask(taskId);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: `Task ${taskId} started successfully`,
+                        task: {
+                            id: task.id,
+                            title: task.title,
+                            status: task.status,
+                            type: task.type,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Handle finish_task tool
+     */
+    async handleFinishTask(taskId) {
+        const task = await this.taskManager.finishTask(taskId);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: `Task ${taskId} finished successfully`,
+                        task: {
+                            id: task.id,
+                            title: task.title,
+                            status: task.status,
+                            type: task.type,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * List available prompts
+     */
+    listPrompts() {
+        const prompts = [
+            {
+                name: 'start-task-workflow',
+                description: 'Guide the user through starting work on a task with git branch creation',
+                arguments: [
+                    {
+                        name: 'taskId',
+                        description: 'The task ID to start',
+                        required: true,
+                    },
+                ],
+            },
+            {
+                name: 'finish-task-workflow',
+                description: 'Guide the user through completing a task with commit and PR creation',
+                arguments: [
+                    {
+                        name: 'taskId',
+                        description: 'The task ID to finish',
+                        required: true,
+                    },
+                ],
+            },
+            {
+                name: 'task-summary',
+                description: 'Generate a summary of a task for documentation or reports',
+                arguments: [
+                    {
+                        name: 'taskId',
+                        description: 'The task ID to summarize',
+                        required: true,
+                    },
+                ],
+            },
+        ];
+        return { prompts };
+    }
+    /**
+     * Get a prompt
+     */
+    async getPrompt(params) {
+        this.log(`Getting prompt: ${params.name}`, params.arguments);
+        switch (params.name) {
+            case 'start-task-workflow':
+                return {
+                    description: 'Workflow for starting a task',
+                    messages: [
+                        {
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `I want to start working on task ${params.arguments?.taskId}. Can you help me set everything up?`,
+                            },
+                        },
+                        {
+                            role: 'assistant',
+                            content: {
+                                type: 'text',
+                                text: `I'll help you start working on task ${params.arguments?.taskId}. Here's what I'll do:
+
+1. Mark the task as "in-progress"
+2. Create a git branch based on the task type and ID
+3. Ensure your working directory is clean
+4. Switch to the new branch
+
+Let me start by marking the task as in-progress using the start_task tool.`,
+                            },
+                        },
+                    ],
+                };
+            case 'finish-task-workflow':
+                return {
+                    description: 'Workflow for finishing a task',
+                    messages: [
+                        {
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `I've completed task ${params.arguments?.taskId}. What should I do next?`,
+                            },
+                        },
+                        {
+                            role: 'assistant',
+                            content: {
+                                type: 'text',
+                                text: `Great! Let me help you finish task ${params.arguments?.taskId}. Here's the workflow:
+
+1. Mark the task as "done"
+2. Ensure all changes are committed
+3. Push your branch to remote
+4. Create a pull request
+
+Let me start by marking the task as done using the finish_task tool.`,
+                            },
+                        },
+                    ],
+                };
+            case 'task-summary':
+                return {
+                    description: 'Generate task summary',
+                    messages: [
+                        {
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `Can you provide a summary of task ${params.arguments?.taskId}?`,
+                            },
+                        },
+                        {
+                            role: 'assistant',
+                            content: {
+                                type: 'text',
+                                text: `I'll generate a comprehensive summary of task ${params.arguments?.taskId} including its current status, description, and any relevant metadata.`,
+                            },
+                        },
+                    ],
+                };
+            default:
+                throw new Error(`Unknown prompt: ${params.name}`);
+        }
+    }
+    /**
+     * List available resources
+     */
+    async listResources() {
+        // In a real implementation, we would list all tasks as resources
+        // For now, returning an example structure
+        return {
+            resources: [
+                {
+                    uri: 'taskin://tasks',
+                    name: 'All Tasks',
+                    description: 'Access to all tasks in the system',
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    }
+    /**
+     * Read a resource
+     */
+    async readResource(params) {
+        this.log(`Reading resource: ${params.uri}`);
+        // Parse URI (e.g., "taskin://tasks" or "taskin://task/123")
+        const uri = params.uri;
+        if (uri === 'taskin://tasks') {
+            // In a real implementation, we would fetch all tasks
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({
+                            message: 'Task list would be here',
+                            note: 'Requires ITaskProvider integration',
+                        }),
+                    },
+                ],
+            };
+        }
+        throw new Error(`Unknown resource: ${uri}`);
+    }
+    /**
+     * Debug logging
+     */
+    log(...args) {
+        if (this.config.debug) {
+            console.error('[TaskMCPServer]', ...args);
+        }
+    }
+}
+/**
+ * Create and connect a MCP server for task management
+ */
+export async function createTaskMCPServer(taskManager, options) {
+    const server = new TaskMCPServer({
+        taskManager,
+        ...options,
+    });
+    // Default to stdio transport
+    await server.connect({ transport: 'stdio' });
+    return server;
+}
+//# sourceMappingURL=task-server-mcp.js.map

package/dist/task-server-mcp.js.map

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

package/dist/task-server-mcp.mock.d.ts

@@ -0,0 +1,66 @@
+import type { CreateTaskOptions, CreateTaskResult, ITaskManager, LintResult, TaskFile } from '@opentask/taskin-task-manager';
+import type { MCPServerConfig } from './task-server-mcp.types.js';
+/**
+ * Mock TaskManager for MCP testing
+ */
+export declare class MockMCPTaskManager implements ITaskManager {
+    private tasks;
+    constructor();
+    startTask(taskId: string): Promise<TaskFile>;
+    finishTask(taskId: string): Promise<TaskFile>;
+    createTask(options: CreateTaskOptions): Promise<CreateTaskResult>;
+    lint(): Promise<LintResult>;
+    /**
+     * Get all tasks (for testing)
+     */
+    getAllTasks(): TaskFile[];
+    /**
+     * Get task by ID (for testing)
+     */
+    getTask(taskId: string): TaskFile | undefined;
+}
+/**
+ * Create mock MCP server configuration
+ */
+export declare function createMockMCPServerConfig(overrides?: Partial<MCPServerConfig>): MCPServerConfig;
+/**
+ * Mock tool call scenarios
+ */
+export declare const mockToolCalls: {
+    startTask: (taskId: string) => {
+        name: string;
+        arguments: {
+            taskId: string;
+        };
+    };
+    finishTask: (taskId: string) => {
+        name: string;
+        arguments: {
+            taskId: string;
+        };
+    };
+};
+/**
+ * Mock prompt scenarios
+ */
+export declare const mockPromptRequests: {
+    startWorkflow: (taskId: string) => {
+        name: string;
+        arguments: {
+            taskId: string;
+        };
+    };
+    finishWorkflow: (taskId: string) => {
+        name: string;
+        arguments: {
+            taskId: string;
+        };
+    };
+    taskSummary: (taskId: string) => {
+        name: string;
+        arguments: {
+            taskId: string;
+        };
+    };
+};
+//# sourceMappingURL=task-server-mcp.mock.d.ts.map

package/dist/task-server-mcp.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-server-mcp.mock.d.ts","sourceRoot":"","sources":["../src/task-server-mcp.mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,QAAQ,EACT,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,KAAK,CAAoC;;IA2B3C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmB5C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAW7C,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBjE,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAUjC;;OAEG;IACH,WAAW,IAAI,QAAQ,EAAE;IAIzB;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;CAG9C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACnC,eAAe,CAQjB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;wBACJ,MAAM;;;;;;yBAKL,MAAM;;;;;;CAI5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB;4BACL,MAAM;;;;;;6BAKL,MAAM;;;;;;0BAKT,MAAM;;;;;;CAI7B,CAAC"}

package/dist/task-server-mcp.mock.js

@@ -0,0 +1,135 @@
+/**
+ * Mock TaskManager for MCP testing
+ */
+export class MockMCPTaskManager {
+    tasks = new Map();
+    constructor() {
+        // Add some mock tasks
+        this.tasks.set('550e8400-e29b-41d4-a716-446655440001', {
+            id: '550e8400-e29b-41d4-a716-446655440001',
+            title: 'Implement user authentication',
+            description: 'Add JWT-based authentication',
+            status: 'pending',
+            type: 'feat',
+            filePath: './TASKS/task-001.md',
+            content: '# Task 001',
+            createdAt: new Date().toISOString(),
+        });
+        this.tasks.set('550e8400-e29b-41d4-a716-446655440002', {
+            id: '550e8400-e29b-41d4-a716-446655440002',
+            title: 'Fix login bug',
+            description: 'Users cannot login with special characters',
+            status: 'in-progress',
+            type: 'fix',
+            filePath: './TASKS/task-002.md',
+            content: '# Task 002',
+            createdAt: new Date().toISOString(),
+        });
+    }
+    async startTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task ${taskId} not found`);
+        }
+        if (task.status === 'in-progress') {
+            throw new Error(`Task ${taskId} is already in progress`);
+        }
+        if (task.status === 'done') {
+            throw new Error(`Task ${taskId} is already done`);
+        }
+        task.status = 'in-progress';
+        this.tasks.set(taskId, task);
+        return task;
+    }
+    async finishTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task ${taskId} not found`);
+        }
+        task.status = 'done';
+        this.tasks.set(taskId, task);
+        return task;
+    }
+    async createTask(options) {
+        const taskId = String(this.tasks.size + 1).padStart(3, '0');
+        const task = {
+            id: taskId,
+            title: options.title,
+            status: 'pending',
+            type: options.type,
+            filePath: `./TASKS/task-${taskId}.md`,
+            content: `# Task ${taskId}`,
+            createdAt: new Date().toISOString(),
+        };
+        this.tasks.set(taskId, task);
+        return {
+            task,
+            taskId,
+            filePath: task.filePath,
+        };
+    }
+    async lint() {
+        return {
+            valid: true,
+            issues: [],
+            errorCount: 0,
+            warningCount: 0,
+            infoCount: 0,
+        };
+    }
+    /**
+     * Get all tasks (for testing)
+     */
+    getAllTasks() {
+        return Array.from(this.tasks.values());
+    }
+    /**
+     * Get task by ID (for testing)
+     */
+    getTask(taskId) {
+        return this.tasks.get(taskId);
+    }
+}
+/**
+ * Create mock MCP server configuration
+ */
+export function createMockMCPServerConfig(overrides) {
+    return {
+        taskManager: new MockMCPTaskManager(),
+        name: 'test-mcp-server',
+        version: '0.0.1',
+        debug: true,
+        ...overrides,
+    };
+}
+/**
+ * Mock tool call scenarios
+ */
+export const mockToolCalls = {
+    startTask: (taskId) => ({
+        name: 'start_task',
+        arguments: { taskId },
+    }),
+    finishTask: (taskId) => ({
+        name: 'finish_task',
+        arguments: { taskId },
+    }),
+};
+/**
+ * Mock prompt scenarios
+ */
+export const mockPromptRequests = {
+    startWorkflow: (taskId) => ({
+        name: 'start-task-workflow',
+        arguments: { taskId },
+    }),
+    finishWorkflow: (taskId) => ({
+        name: 'finish-task-workflow',
+        arguments: { taskId },
+    }),
+    taskSummary: (taskId) => ({
+        name: 'task-summary',
+        arguments: { taskId },
+    }),
+};
+//# sourceMappingURL=task-server-mcp.mock.js.map

package/dist/task-server-mcp.mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-server-mcp.mock.js","sourceRoot":"","sources":["../src/task-server-mcp.mock.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,KAAK,GAA0B,IAAI,GAAG,EAAE,CAAC;IAEjD;QACE,sBAAsB;QACtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sCAAsC,EAAE;YACrD,EAAE,EAAE,sCAA6C;YACjD,KAAK,EAAE,+BAA+B;YACtC,WAAW,EAAE,8BAA8B;YAC3C,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,qBAAqB;YAC/B,OAAO,EAAE,YAAY;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sCAAsC,EAAE;YACrD,EAAE,EAAE,sCAA6C;YACjD,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,4CAA4C;YACzD,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,qBAAqB;YAC/B,OAAO,EAAE,YAAY;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,yBAAyB,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,kBAAkB,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAA0B;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAa;YACrB,EAAE,EAAE,MAAa;YACjB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,gBAAgB,MAAM,KAAK;YACrC,OAAO,EAAE,UAAU,MAAM,EAAE;YAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO;YACL,IAAI;YACJ,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,CAAC;YACf,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,MAAc;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAAoC;IAEpC,OAAO;QACL,WAAW,EAAE,IAAI,kBAAkB,EAAE;QACrC,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,IAAI;QACX,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,EAAE,MAAM,EAAE;KACtB,CAAC;IAEF,UAAU,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,EAAE,MAAM,EAAE;KACtB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,EAAE,qBAAqB;QAC3B,SAAS,EAAE,EAAE,MAAM,EAAE;KACtB,CAAC;IAEF,cAAc,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,sBAAsB;QAC5B,SAAS,EAAE,EAAE,MAAM,EAAE;KACtB,CAAC;IAEF,WAAW,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,EAAE,MAAM,EAAE;KACtB,CAAC;CACH,CAAC"}

package/dist/task-server-mcp.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-server-mcp.test.d.ts.map

package/dist/task-server-mcp.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-server-mcp.test.d.ts","sourceRoot":"","sources":["../src/task-server-mcp.test.ts"],"names":[],"mappings":""}

package/dist/task-server-mcp.test.js

@@ -0,0 +1,9 @@
+import { describe, expect, it } from 'vitest';
+import { TaskMCPServer } from './task-server-mcp.js';
+describe('TaskMCPServer', () => {
+    it('should export TaskMCPServer class', () => {
+        expect(TaskMCPServer).toBeDefined();
+        expect(typeof TaskMCPServer).toBe('function');
+    });
+});
+//# sourceMappingURL=task-server-mcp.test.js.map

package/dist/task-server-mcp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-server-mcp.test.js","sourceRoot":"","sources":["../src/task-server-mcp.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/task-server-mcp.types.d.ts

@@ -0,0 +1,259 @@
+import type { ITaskManager } from '@opentask/taskin-task-manager';
+/**
+ * MCP Server configuration
+ */
+export interface MCPServerConfig {
+    /**
+     * TaskManager instance to expose via MCP
+     */
+    taskManager: ITaskManager;
+    /**
+     * Server name
+     * @default 'taskin-mcp-server'
+     */
+    name?: string;
+    /**
+     * Server version
+     * @default '1.0.0'
+     */
+    version?: string;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * MCP Tool definition
+ */
+export interface MCPTool {
+    /**
+     * Unique tool identifier
+     */
+    name: string;
+    /**
+     * Human-readable description
+     */
+    description: string;
+    /**
+     * Input schema (JSON Schema)
+     */
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * MCP Prompt definition
+ */
+export interface MCPPrompt {
+    /**
+     * Unique prompt identifier
+     */
+    name: string;
+    /**
+     * Human-readable description
+     */
+    description: string;
+    /**
+     * Optional arguments
+     */
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+/**
+ * MCP Resource definition
+ */
+export interface MCPResource {
+    /**
+     * Resource URI (e.g., "task://123")
+     */
+    uri: string;
+    /**
+     * Human-readable name
+     */
+    name: string;
+    /**
+     * Resource description
+     */
+    description?: string;
+    /**
+     * MIME type
+     */
+    mimeType?: string;
+}
+/**
+ * MCP Tool call parameters
+ */
+export interface MCPToolCallParams {
+    /**
+     * Tool name
+     */
+    name: string;
+    /**
+     * Tool arguments
+     */
+    arguments?: Record<string, unknown>;
+}
+/**
+ * MCP Tool call result
+ */
+export interface MCPToolCallResult {
+    /**
+     * Result content
+     */
+    content: Array<{
+        type: 'text' | 'image' | 'resource';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    /**
+     * Whether the call was successful
+     */
+    isError?: boolean;
+}
+/**
+ * MCP Prompt get parameters
+ */
+export interface MCPPromptGetParams {
+    /**
+     * Prompt name
+     */
+    name: string;
+    /**
+     * Prompt arguments
+     */
+    arguments?: Record<string, string>;
+}
+/**
+ * MCP Prompt messages
+ */
+export interface MCPPromptMessage {
+    /**
+     * Message role
+     */
+    role: 'user' | 'assistant';
+    /**
+     * Message content
+     */
+    content: {
+        type: 'text' | 'image' | 'resource';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    };
+}
+/**
+ * MCP Prompt get result
+ */
+export interface MCPPromptGetResult {
+    /**
+     * Prompt description
+     */
+    description?: string;
+    /**
+     * Prompt messages
+     */
+    messages: MCPPromptMessage[];
+}
+/**
+ * MCP Resource read parameters
+ */
+export interface MCPResourceReadParams {
+    /**
+     * Resource URI
+     */
+    uri: string;
+}
+/**
+ * MCP Resource read result
+ */
+export interface MCPResourceReadResult {
+    /**
+     * Resource contents
+     */
+    contents: Array<{
+        uri: string;
+        mimeType?: string;
+        text?: string;
+        blob?: string;
+    }>;
+}
+/**
+ * MCP Resource list result
+ */
+export interface MCPResourceListResult {
+    /**
+     * Available resources
+     */
+    resources: MCPResource[];
+}
+/**
+ * Task server MCP interface
+ */
+export interface ITaskMCPServer {
+    /**
+     * Get server information
+     */
+    getServerInfo(): {
+        name: string;
+        version: string;
+        protocolVersion: string;
+        capabilities: {
+            tools?: Record<string, unknown>;
+            prompts?: Record<string, unknown>;
+            resources?: Record<string, unknown>;
+        };
+    };
+    /**
+     * List available tools
+     */
+    listTools(): {
+        tools: MCPTool[];
+    };
+    /**
+     * Call a tool
+     */
+    callTool(params: MCPToolCallParams): Promise<MCPToolCallResult>;
+    /**
+     * List available prompts
+     */
+    listPrompts(): {
+        prompts: MCPPrompt[];
+    };
+    /**
+     * Get a prompt
+     */
+    getPrompt(params: MCPPromptGetParams): Promise<MCPPromptGetResult>;
+    /**
+     * List available resources
+     */
+    listResources(): Promise<MCPResourceListResult>;
+    /**
+     * Read a resource
+     */
+    readResource(params: MCPResourceReadParams): Promise<MCPResourceReadResult>;
+}
+/**
+ * MCP Transport type
+ */
+export type MCPTransportType = 'stdio' | 'sse';
+/**
+ * MCP Connection options
+ */
+export interface MCPConnectionOptions {
+    /**
+     * Transport type
+     */
+    transport: MCPTransportType;
+    /**
+     * Additional transport options
+     */
+    options?: Record<string, unknown>;
+}
+//# sourceMappingURL=task-server-mcp.types.d.ts.map

package/dist/task-server-mcp.types.d.ts.map

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

package/dist/task-server-mcp.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-server-mcp.types.js.map

package/dist/task-server-mcp.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-server-mcp.types.js","sourceRoot":"","sources":["../src/task-server-mcp.types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@opentask/taskin-task-server-mcp",
+  "version": "0.1.1",
+  "description": "Model Context Protocol (MCP) server for task management integration with LLMs",
+  "motivation": "Enable LLMs to interact with task management systems",
+  "solve": "Provides MCP server implementation for task operations",
+  "scope": "mcp-server",
+  "status": "active",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@opentask/taskin-task-manager": "1.0.5",
+    "@opentask/taskin-types": "1.0.5",
+    "@opentask/taskin-file-system-provider": "2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@vitest/ui": "^2.1.8",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "keywords": [
+    "taskin",
+    "mcp",
+    "model-context-protocol",
+    "llm",
+    "ai",
+    "task-management"
+  ],
+  "author": {
+    "name": "OpenTask",
+    "url": "https://opentask.com.br"
+  },
+  "contributors": [
+    {
+      "name": "Sidarta Veloso",
+      "url": "https://github.com/sidartaveloso"
+    }
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sidartaveloso/taskin.git",
+    "directory": "packages/task-server-mcp"
+  },
+  "files": [
+    "dist",
+    "mcp-server.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:ui": "vitest --ui",
+    "type-check": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --fix"
+  }
+}