@damper/mcp 0.1.1 → 0.1.2

package/dist/index.js

@@ -30,6 +30,48 @@ const server = new McpServer({
     name: 'damper',
     version: '0.1.0',
 });
+// Output schemas
+const TaskSummarySchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    status: z.string(),
+    priority: z.string(),
+    feedbackCount: z.number(),
+    hasImplementationPlan: z.boolean(),
+});
+const TaskDetailSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    description: z.string().optional(),
+    implementationPlan: z.string().optional(),
+    status: z.string(),
+    voteScore: z.number(),
+    agentNotes: z.string().optional(),
+    feedback: z.array(z.object({
+        id: z.string(),
+        title: z.string(),
+        description: z.string(),
+        voterCount: z.number(),
+    })),
+});
+const FeedbackSummarySchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    type: z.string(),
+    voterCount: z.number(),
+    linkedTaskId: z.string().optional(),
+});
+const FeedbackDetailSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    description: z.string(),
+    type: z.string(),
+    status: z.string(),
+    voteScore: z.number(),
+    linkedTaskId: z.string().optional(),
+    voters: z.array(z.object({ email: z.string(), plan: z.string() })),
+    comments: z.array(z.object({ author: z.string(), body: z.string() })),
+});
 // Tool: List tasks
 server.registerTool('list_tasks', {
     title: 'List Tasks',
@@ -38,6 +80,16 @@ server.registerTool('list_tasks', {
         status: z.enum(['planned', 'in_progress', 'done', 'all']).optional(),
         limit: z.number().optional(),
     }),
+    outputSchema: z.object({
+        project: z.string(),
+        tasks: z.array(TaskSummarySchema),
+    }),
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
 }, async ({ status, limit }) => {
     const params = new URLSearchParams();
     if (status)
@@ -47,7 +99,10 @@ server.registerTool('list_tasks', {
     const query = params.toString();
     const data = await api('GET', `/api/agent/tasks${query ? `?${query}` : ''}`);
     if (!data.tasks.length) {
-        return { content: [{ type: 'text', text: `No tasks in "${data.project.name}"` }] };
+        return {
+            content: [{ type: 'text', text: `No tasks in "${data.project.name}"` }],
+            structuredContent: { project: data.project.name, tasks: [] },
+        };
     }
     const lines = data.tasks.map((t) => {
         const p = t.priority === 'high' ? '🔴' : t.priority === 'medium' ? '🟡' : '⚪';
@@ -55,6 +110,7 @@ server.registerTool('list_tasks', {
     });
     return {
         content: [{ type: 'text', text: `Tasks in "${data.project.name}":\n${lines.join('\n')}` }],
+        structuredContent: { project: data.project.name, tasks: data.tasks },
     };
 });
 // Tool: Get task
@@ -64,6 +120,13 @@ server.registerTool('get_task', {
     inputSchema: z.object({
         taskId: z.string().describe('Task ID'),
     }),
+    outputSchema: TaskDetailSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
 }, async ({ taskId }) => {
     const t = await api('GET', `/api/agent/tasks/${taskId}`);
     const parts = [
@@ -80,7 +143,10 @@ server.registerTool('get_task', {
         parts.push(`\n## Feedback (${t.feedback.length})`);
         t.feedback.forEach((f) => parts.push(`- ${f.title} (${f.voterCount} votes)`));
     }
-    return { content: [{ type: 'text', text: parts.join('\n') }] };
+    return {
+        content: [{ type: 'text', text: parts.join('\n') }],
+        structuredContent: t,
+    };
 });
 // Tool: Create task
 server.registerTool('create_task', {
@@ -92,10 +158,22 @@ server.registerTool('create_task', {
         status: z.enum(['planned', 'in_progress']).optional(),
         implementationPlan: z.string().optional(),
     }),
+    outputSchema: z.object({
+        id: z.string(),
+        title: z.string(),
+        status: z.string(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
 }, async (args) => {
     const result = await api('POST', '/api/agent/tasks', args);
     return {
         content: [{ type: 'text', text: `Created: ${result.id} "${result.title}" [${result.status}]` }],
+        structuredContent: result,
     };
 });
 // Tool: Start task
@@ -105,9 +183,23 @@ server.registerTool('start_task', {
     inputSchema: z.object({
         taskId: z.string(),
     }),
+    outputSchema: z.object({
+        id: z.string(),
+        status: z.string(),
+        message: z.string(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
 }, async ({ taskId }) => {
     const result = await api('POST', `/api/agent/tasks/${taskId}/start`);
-    return { content: [{ type: 'text', text: `Started ${result.id}: ${result.message}` }] };
+    return {
+        content: [{ type: 'text', text: `Started ${result.id}: ${result.message}` }],
+        structuredContent: result,
+    };
 });
 // Tool: Add note
 server.registerTool('add_note', {
@@ -117,9 +209,22 @@ server.registerTool('add_note', {
         taskId: z.string(),
         note: z.string(),
     }),
+    outputSchema: z.object({
+        taskId: z.string(),
+        success: z.boolean(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
 }, async ({ taskId, note }) => {
     await api('POST', `/api/agent/tasks/${taskId}/notes`, { note });
-    return { content: [{ type: 'text', text: `Note added to ${taskId}` }] };
+    return {
+        content: [{ type: 'text', text: `Note added to ${taskId}` }],
+        structuredContent: { taskId, success: true },
+    };
 });
 // Tool: Complete task
 server.registerTool('complete_task', {
@@ -129,9 +234,22 @@ server.registerTool('complete_task', {
         taskId: z.string(),
         summary: z.string().describe('What was implemented'),
     }),
+    outputSchema: z.object({
+        id: z.string(),
+        status: z.string(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
 }, async ({ taskId, summary }) => {
     const result = await api('POST', `/api/agent/tasks/${taskId}/complete`, { summary });
-    return { content: [{ type: 'text', text: `Completed ${result.id}` }] };
+    return {
+        content: [{ type: 'text', text: `Completed ${result.id}` }],
+        structuredContent: result,
+    };
 });
 // Tool: List feedback
 server.registerTool('list_feedback', {
@@ -141,6 +259,15 @@ server.registerTool('list_feedback', {
         status: z.enum(['new', 'under_review', 'planned', 'in_progress', 'done', 'closed']).optional(),
         limit: z.number().optional(),
     }),
+    outputSchema: z.object({
+        feedback: z.array(FeedbackSummarySchema),
+    }),
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
 }, async ({ status, limit }) => {
     const params = new URLSearchParams();
     if (status)
@@ -150,13 +277,19 @@ server.registerTool('list_feedback', {
     const query = params.toString();
     const data = await api('GET', `/api/agent/feedback${query ? `?${query}` : ''}`);
     if (!data.feedback.length) {
-        return { content: [{ type: 'text', text: 'No feedback found' }] };
+        return {
+            content: [{ type: 'text', text: 'No feedback found' }],
+            structuredContent: { feedback: [] },
+        };
     }
     const lines = data.feedback.map((f) => {
         const link = f.linkedTaskId ? ` → ${f.linkedTaskId}` : '';
         return `• ${f.id}: ${f.title} [${f.type}] (${f.voterCount} votes)${link}`;
     });
-    return { content: [{ type: 'text', text: `Feedback:\n${lines.join('\n')}` }] };
+    return {
+        content: [{ type: 'text', text: `Feedback:\n${lines.join('\n')}` }],
+        structuredContent: { feedback: data.feedback },
+    };
 });
 // Tool: Get feedback
 server.registerTool('get_feedback', {
@@ -165,6 +298,13 @@ server.registerTool('get_feedback', {
     inputSchema: z.object({
         feedbackId: z.string(),
     }),
+    outputSchema: FeedbackDetailSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
 }, async ({ feedbackId }) => {
     const f = await api('GET', `/api/agent/feedback/${feedbackId}`);
     const parts = [
@@ -185,7 +325,10 @@ server.registerTool('get_feedback', {
         if (f.comments.length > 3)
             parts.push(`... and ${f.comments.length - 3} more`);
     }
-    return { content: [{ type: 'text', text: parts.join('\n') }] };
+    return {
+        content: [{ type: 'text', text: parts.join('\n') }],
+        structuredContent: f,
+    };
 });
 // Start
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damper/mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP server for Damper task management",
   "author": "Damper <hello@usedamper.com>",
   "repository": {
@@ -15,7 +15,9 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/index.ts",
@@ -33,6 +35,11 @@
   "engines": {
     "node": ">=18"
   },
-  "keywords": ["mcp", "damper", "ai", "task-management"],
+  "keywords": [
+    "mcp",
+    "damper",
+    "ai",
+    "task-management"
+  ],
   "license": "MIT"
 }