tick-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,245 @@
+# Tick MCP Server
+
+Model Context Protocol (MCP) server for Tick.md multi-agent coordination. Enables AI agents to use Tick commands for task management and coordination.
+
+## Features
+
+- **Task Management**: Create, claim, release, and complete tasks
+- **Agent Coordination**: Register agents and track their work
+- **Validation**: Validate TICK.md files for errors
+- **Status Tracking**: Get real-time project status
+- **Comments**: Add notes to task history
+
+## Installation
+
+### From npm (when published)
+
+```bash
+npm install -g tick-mcp-server
+```
+
+### Local Development
+
+```bash
+cd mcp
+npm install
+npm run build
+```
+
+## MCP Configuration
+
+Add to your MCP settings file (e.g., `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "tick": {
+      "command": "node",
+      "args": ["/path/to/tick-md/mcp/dist/index.js"],
+      "cwd": "/path/to/your/tick/project"
+    }
+  }
+}
+```
+
+Or use npx (when published):
+
+```json
+{
+  "mcpServers": {
+    "tick": {
+      "command": "npx",
+      "args": ["tick-mcp-server"],
+      "cwd": "/path/to/your/tick/project"
+    }
+  }
+}
+```
+
+## Available Tools
+
+### `tick_status`
+
+Get current project status including tasks, agents, and progress.
+
+**Returns:** JSON with project overview, agent list, task summary by status
+
+### `tick_add`
+
+Create a new task.
+
+**Parameters:**
+- `title` (required): Task title
+- `priority`: urgent|high|medium|low (default: medium)
+- `tags`: Array of tags
+- `assignedTo`: Agent to assign to
+- `description`: Detailed description
+- `dependsOn`: Array of task IDs this depends on
+- `estimatedHours`: Estimated hours to complete
+
+**Returns:** Task ID of created task
+
+### `tick_claim`
+
+Claim a task for an agent.
+
+**Parameters:**
+- `taskId` (required): Task ID (e.g., "TASK-001")
+- `agent` (required): Agent name (e.g., "@agent-name")
+
+**Returns:** Confirmation message
+
+### `tick_release`
+
+Release a claimed task back to todo.
+
+**Parameters:**
+- `taskId` (required): Task ID
+- `agent` (required): Agent name
+
+**Returns:** Confirmation message
+
+### `tick_done`
+
+Mark a task as complete. Automatically unblocks dependent tasks.
+
+**Parameters:**
+- `taskId` (required): Task ID
+- `agent` (required): Agent name
+
+**Returns:** Confirmation message
+
+### `tick_comment`
+
+Add a comment to a task's history.
+
+**Parameters:**
+- `taskId` (required): Task ID
+- `agent` (required): Agent name
+- `note` (required): Comment text
+
+**Returns:** Confirmation message
+
+### `tick_validate`
+
+Validate TICK.md for errors and warnings.
+
+**Returns:** JSON with validation results (errors, warnings, summary)
+
+### `tick_agent_list`
+
+List all registered agents.
+
+**Parameters:**
+- `status` (optional): Filter by status (working|idle|offline)
+- `type` (optional): Filter by type (human|bot)
+
+**Returns:** JSON with agent list
+
+### `tick_agent_register`
+
+Register a new agent.
+
+**Parameters:**
+- `name` (required): Agent name (e.g., "@bot-name")
+- `type`: human|bot (default: human)
+- `roles`: Array of roles (default: ["developer"])
+- `status`: working|idle|offline (default: idle)
+
+**Returns:** Confirmation message
+
+## Usage Example
+
+Once configured, AI agents (like Claude) can use these tools:
+
+```
+AI: I'll help you create a task for the authentication system.
+
+[Uses tick_add tool with:
+  title: "Build authentication system"
+  priority: "high"
+  tags: ["backend", "security"]
+]
+
+AI: I've created TASK-023. Now let me claim it for myself.
+
+[Uses tick_claim tool with:
+  taskId: "TASK-023"
+  agent: "@claude-agent"
+]
+
+AI: I've claimed the task and I'm working on it now.
+```
+
+## Architecture
+
+The MCP server acts as a bridge between AI agents and the Tick CLI:
+
+```
+AI Agent (Claude/etc)
+    ↓
+MCP Protocol
+    ↓
+Tick MCP Server
+    ↓
+Tick CLI Commands
+    ↓
+TICK.md File
+```
+
+### Key Features
+
+- **Reuses CLI Logic**: Imports commands from `../cli/src/commands/`
+- **Stateless**: Each tool call reads/writes TICK.md
+- **Safe**: All CLI validation and locking apply
+- **JSON Responses**: Returns structured data for AI consumption
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Test (requires a Tick project in the directory)
+node dist/index.js
+```
+
+## Requirements
+
+- Node.js 18+
+- A Tick project (with TICK.md file)
+- MCP-compatible AI client
+
+## Error Handling
+
+All tools return error messages in the response if something goes wrong:
+
+```json
+{
+  "content": [
+    {
+      "type": "text",
+      "text": "Error: Task TASK-999 not found"
+    }
+  ],
+  "isError": true
+}
+```
+
+## Best Practices
+
+1. **Check Status First**: Use `tick_status` to understand the project state
+2. **Validate Often**: Run `tick_validate` after making changes
+3. **Descriptive Comments**: Use `tick_comment` to explain progress
+4. **Proper Workflow**: claim → work → comment → done
+5. **Register First**: Register as an agent before claiming tasks
+
+## License
+
+MIT · Purple Horizons

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,466 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import * as fs from "node:fs";
+// @ts-ignore - CLI imports resolved at runtime
+import { parseTickFile } from "../../cli/dist/parser/parse.js";
+// @ts-ignore
+import { addCommand } from "../../cli/dist/commands/add.js";
+// @ts-ignore
+import { claimCommand, releaseCommand } from "../../cli/dist/commands/claim.js";
+// @ts-ignore
+import { doneCommand, commentCommand } from "../../cli/dist/commands/done.js";
+// @ts-ignore
+import { validateTickFile } from "../../cli/dist/utils/validator.js";
+// @ts-ignore
+import { registerAgentCommand } from "../../cli/dist/commands/agent.js";
+/**
+ * Tick MCP Server
+ *
+ * Provides MCP tools for AI agents to coordinate work via Tick.md files.
+ * Exposes tick CLI functionality as MCP tools.
+ */
+const server = new Server({
+    name: "tick-mcp-server",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Helper to check if TICK.md exists
+function checkTickFile() {
+    if (!fs.existsSync("TICK.md")) {
+        throw new Error("TICK.md not found. Run 'tick init' first or navigate to a Tick project directory.");
+    }
+}
+// Tool definitions
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "tick_status",
+                description: "Get the current status of the Tick project, including all tasks, agents, and progress summary.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "tick_add",
+                description: "Create a new task in the Tick project. Returns the new task ID.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        title: {
+                            type: "string",
+                            description: "Task title (required)",
+                        },
+                        priority: {
+                            type: "string",
+                            enum: ["urgent", "high", "medium", "low"],
+                            description: "Task priority (default: medium)",
+                        },
+                        tags: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Tags for the task",
+                        },
+                        assignedTo: {
+                            type: "string",
+                            description: "Agent to assign the task to",
+                        },
+                        description: {
+                            type: "string",
+                            description: "Detailed task description",
+                        },
+                        dependsOn: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Task IDs this task depends on",
+                        },
+                        estimatedHours: {
+                            type: "number",
+                            description: "Estimated hours to complete",
+                        },
+                    },
+                    required: ["title"],
+                },
+            },
+            {
+                name: "tick_claim",
+                description: "Claim a task for an agent. Sets status to in_progress and acquires a lock.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        taskId: {
+                            type: "string",
+                            description: "Task ID to claim (e.g., TASK-001)",
+                        },
+                        agent: {
+                            type: "string",
+                            description: "Agent name claiming the task (e.g., @agent-name)",
+                        },
+                    },
+                    required: ["taskId", "agent"],
+                },
+            },
+            {
+                name: "tick_release",
+                description: "Release a claimed task back to todo status and remove the lock.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        taskId: {
+                            type: "string",
+                            description: "Task ID to release",
+                        },
+                        agent: {
+                            type: "string",
+                            description: "Agent name releasing the task",
+                        },
+                    },
+                    required: ["taskId", "agent"],
+                },
+            },
+            {
+                name: "tick_done",
+                description: "Mark a task as complete. Automatically unblocks dependent tasks.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        taskId: {
+                            type: "string",
+                            description: "Task ID to complete",
+                        },
+                        agent: {
+                            type: "string",
+                            description: "Agent completing the task",
+                        },
+                    },
+                    required: ["taskId", "agent"],
+                },
+            },
+            {
+                name: "tick_comment",
+                description: "Add a comment/note to a task's history.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        taskId: {
+                            type: "string",
+                            description: "Task ID to comment on",
+                        },
+                        agent: {
+                            type: "string",
+                            description: "Agent adding the comment",
+                        },
+                        note: {
+                            type: "string",
+                            description: "Comment text",
+                        },
+                    },
+                    required: ["taskId", "agent", "note"],
+                },
+            },
+            {
+                name: "tick_validate",
+                description: "Validate the TICK.md file for errors and warnings. Returns validation results.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "tick_agent_list",
+                description: "List all registered agents with their current status and task assignments.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        status: {
+                            type: "string",
+                            enum: ["working", "idle", "offline"],
+                            description: "Filter agents by status",
+                        },
+                        type: {
+                            type: "string",
+                            enum: ["human", "bot"],
+                            description: "Filter agents by type",
+                        },
+                    },
+                },
+            },
+            {
+                name: "tick_agent_register",
+                description: "Register a new agent (human or bot) in the Tick project.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "Agent name (e.g., @bot-name)",
+                        },
+                        type: {
+                            type: "string",
+                            enum: ["human", "bot"],
+                            description: "Agent type (default: human)",
+                        },
+                        roles: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Agent roles (e.g., developer, reviewer)",
+                        },
+                        status: {
+                            type: "string",
+                            enum: ["working", "idle", "offline"],
+                            description: "Initial status (default: idle)",
+                        },
+                    },
+                    required: ["name"],
+                },
+            },
+        ],
+    };
+});
+// Tool execution
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "tick_status": {
+                checkTickFile();
+                const content = fs.readFileSync("TICK.md", "utf-8");
+                const tickFile = parseTickFile(content);
+                // Group tasks by status
+                const tasksByStatus = tickFile.tasks.reduce((acc, task) => {
+                    if (!acc[task.status])
+                        acc[task.status] = [];
+                    acc[task.status].push(task);
+                    return acc;
+                }, {});
+                // Calculate progress
+                const done = tickFile.tasks.filter((t) => t.status === "done").length;
+                const total = tickFile.tasks.length;
+                const percentage = total > 0 ? Math.round((done / total) * 100) : 0;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                project: tickFile.meta.project,
+                                updated: tickFile.meta.updated,
+                                agents: tickFile.agents.map((a) => ({
+                                    name: a.name,
+                                    type: a.type,
+                                    status: a.status,
+                                    roles: a.roles,
+                                    working_on: a.working_on,
+                                })),
+                                tasks: {
+                                    total,
+                                    done,
+                                    percentage,
+                                    by_status: Object.entries(tasksByStatus).map(([status, tasks]) => ({
+                                        status,
+                                        count: tasks.length,
+                                        tasks: tasks.map((t) => ({
+                                            id: t.id,
+                                            title: t.title,
+                                            priority: t.priority,
+                                            assigned_to: t.assigned_to,
+                                            claimed_by: t.claimed_by,
+                                        })),
+                                    })),
+                                },
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "tick_add": {
+                checkTickFile();
+                const { title, priority = "medium", tags = [], assignedTo, description, dependsOn = [], estimatedHours, } = args;
+                // Capture stdout to get task ID
+                let taskId = "";
+                const originalLog = console.log;
+                console.log = (msg) => {
+                    if (msg.includes("Created TASK-")) {
+                        const match = msg.match(/TASK-\d+/);
+                        if (match)
+                            taskId = match[0];
+                    }
+                };
+                await addCommand(title, {
+                    priority: priority,
+                    tags,
+                    assignedTo,
+                    description,
+                    dependsOn,
+                    estimatedHours,
+                });
+                console.log = originalLog;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Created task ${taskId}: ${title}`,
+                        },
+                    ],
+                };
+            }
+            case "tick_claim": {
+                checkTickFile();
+                const { taskId, agent } = args;
+                await claimCommand(taskId, agent);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Task ${taskId} claimed by ${agent}`,
+                        },
+                    ],
+                };
+            }
+            case "tick_release": {
+                checkTickFile();
+                const { taskId, agent } = args;
+                await releaseCommand(taskId, agent);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Task ${taskId} released by ${agent}`,
+                        },
+                    ],
+                };
+            }
+            case "tick_done": {
+                checkTickFile();
+                const { taskId, agent } = args;
+                await doneCommand(taskId, agent);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Task ${taskId} completed by ${agent}`,
+                        },
+                    ],
+                };
+            }
+            case "tick_comment": {
+                checkTickFile();
+                const { taskId, agent, note } = args;
+                await commentCommand(taskId, agent, note);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Added comment to ${taskId}`,
+                        },
+                    ],
+                };
+            }
+            case "tick_validate": {
+                checkTickFile();
+                const content = fs.readFileSync("TICK.md", "utf-8");
+                const tickFile = parseTickFile(content);
+                const result = validateTickFile(tickFile);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                valid: result.valid,
+                                errors: result.errors,
+                                warnings: result.warnings,
+                                summary: {
+                                    tasks_validated: tickFile.tasks.length,
+                                    agents_registered: tickFile.agents.length,
+                                },
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "tick_agent_list": {
+                checkTickFile();
+                const content = fs.readFileSync("TICK.md", "utf-8");
+                const tickFile = parseTickFile(content);
+                let agents = tickFile.agents;
+                const { status, type } = args || {};
+                if (status) {
+                    agents = agents.filter((a) => a.status === status);
+                }
+                if (type) {
+                    agents = agents.filter((a) => a.type === type);
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                agents: agents.map((a) => ({
+                                    name: a.name,
+                                    type: a.type,
+                                    status: a.status,
+                                    roles: a.roles,
+                                    working_on: a.working_on,
+                                    trust_level: a.trust_level,
+                                })),
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "tick_agent_register": {
+                checkTickFile();
+                const { name, type = "human", roles = ["developer"], status = "idle" } = args;
+                // Suppress console output
+                const originalLog = console.log;
+                const originalError = console.error;
+                console.log = () => { };
+                console.error = () => { };
+                await registerAgentCommand(name, {
+                    type,
+                    roles,
+                    status,
+                });
+                console.log = originalLog;
+                console.error = originalError;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Agent ${name} registered (type: ${type}, roles: ${roles.join(", ")})`,
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Tick MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "tick-mcp-server",
+  "version": "1.0.0",
+  "description": "Model Context Protocol server for Tick.md - enables AI agents to coordinate tasks programmatically",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "tick-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "tick",
+    "multi-agent",
+    "coordination",
+    "task-management",
+    "ai-agents",
+    "automation",
+    "claude",
+    "cursor"
+  ],
+  "author": "Purple Horizons",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Purple-Horizons/tick-md.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://github.com/Purple-Horizons/tick-md#readme",
+  "bugs": {
+    "url": "https://github.com/Purple-Horizons/tick-md/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "chalk": "^5.3.0",
+    "gray-matter": "^4.0.3",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ]
+}