super-feedback-mcp 0.2.2 → 0.2.6

package/README.md

@@ -1,6 +1,6 @@
-# Super Feedback MCP Server
+# SuperFeedback MCP Server
 
-An MCP (Model Context Protocol) server that enables AI agents in Cursor to query and resolve client feedback from Super Feedback projects.
+An MCP (Model Context Protocol) server that enables AI agents in Cursor to query and resolve client feedback from SuperFeedback projects.
 
 ## Installation
 
@@ -57,7 +57,7 @@ Or if published to npm:
 *At least one of `ACCESS_CODE` or `ADMIN_CODE` is required. For full functionality (read + resolve), provide both.
 
 **Where to find these codes:**
-- Go to your Super Feedback dashboard
+- Go to your SuperFeedback dashboard
 - Select your project
 - Click "Settings" or the gear icon
 - Copy the "Access Code" and "Admin Code"
@@ -121,7 +121,7 @@ The agent will:
 
 ## How It Works
 
-The MCP server connects to your Super Feedback project via the Convex API using your access code. It transforms the raw feedback data into AI-friendly format with:
+The MCP server connects to your SuperFeedback project via the Convex API using your access code. It transforms the raw feedback data into AI-friendly format with:
 
 - **Element identification**: Multiple selector strategies (ID, test ID, CSS path, XPath)
 - **Route mapping**: Extracts page path and suggests likely source files
@@ -150,7 +150,7 @@ Make sure you've set the `SUPER_FEEDBACK_ACCESS_CODE` in your MCP config's `env`
 
 ### "API error: 401"
 
-Your access code is invalid or expired. Check your project settings in Super Feedback.
+Your access code is invalid or expired. Check your project settings in SuperFeedback.
 
 ### "API error: 404"
 

package/dist/index.js

@@ -39,7 +39,7 @@ async function callConvexAPI(endpoint, options) {
 // Create MCP server
 const server = new McpServer({
     name: "super-feedback",
-    version: "0.2.2",
+    version: "0.2.6",
 });
 // Tool 1: Get feedback summary (lightweight overview)
 server.registerTool("get_feedback_summary", {
@@ -137,8 +137,10 @@ Returns everything needed to work on the feedback:
 - All replies/thread history
 - Design suggestions (if any)
 - Cross-element references (if any)
+- Image attachment count (if any)
 
-Use this after get_feedback_summary to dive into a specific comment.`,
+Use this after get_feedback_summary to dive into a specific comment.
+If the comment has attached images, use get_comment_images to fetch and view them.`,
     inputSchema: {
         commentId: z.string().describe("The comment ID to get full details for"),
     },
@@ -207,6 +209,10 @@ Use this after get_feedback_summary to dive into a specific comment.`,
                 text += `\n  ${change.property}: ${change.oldValue} → ${change.newValue}`;
             });
         }
+        // Note if there are images attached (use get_comment_images to fetch them)
+        if (c.imageUrls && c.imageUrls.length > 0) {
+            text += `\n\n🖼️ Attached Images: ${c.imageUrls.length} image(s) - use get_comment_images("${c.id}") to view`;
+        }
         return {
             content: [{ type: "text", text }],
             structuredContent: { found: true, comment: c },
@@ -221,7 +227,82 @@ Use this after get_feedback_summary to dive into a specific comment.`,
         };
     }
 });
-// Tool 3: Mark feedback as resolved
+// Tool 3: Get images attached to a comment
+server.registerTool("get_comment_images", {
+    title: "Get Comment Images",
+    description: `Fetches and returns the images attached to a feedback comment.
+
+Use this when:
+- get_comment_details indicates a comment has attached images
+- You need to see visual context for the feedback (screenshots, mockups, etc.)
+- The user's feedback references something visual
+
+Returns the images as viewable content. Call this after get_comment_details 
+if you need to see the attached images.`,
+    inputSchema: {
+        commentId: z.string().describe("The comment ID to fetch images for"),
+    },
+    outputSchema: {
+        found: z.boolean(),
+        imageCount: z.number(),
+    },
+}, async ({ commentId }) => {
+    try {
+        const params = getAuthParams();
+        params.set("commentId", commentId);
+        const response = await callConvexAPI(`/api/feedback/ai/comment?${params.toString()}`);
+        if (!response.found || !response.comment) {
+            return {
+                content: [{ type: "text", text: `Comment ${commentId} not found` }],
+                structuredContent: { found: false, imageCount: 0 },
+            };
+        }
+        const c = response.comment;
+        if (!c.imageUrls || c.imageUrls.length === 0) {
+            return {
+                content: [{ type: "text", text: `No images attached to comment ${commentId}` }],
+                structuredContent: { found: true, imageCount: 0 },
+            };
+        }
+        // Fetch images and convert to base64 for MCP ImageContent
+        const imageContents = [];
+        const failedUrls = [];
+        for (const url of c.imageUrls) {
+            try {
+                const imgResponse = await fetch(url);
+                if (imgResponse.ok) {
+                    const buffer = await imgResponse.arrayBuffer();
+                    const base64 = Buffer.from(buffer).toString("base64");
+                    const mimeType = imgResponse.headers.get("content-type") || "image/png";
+                    imageContents.push({ type: "image", data: base64, mimeType });
+                }
+                else {
+                    failedUrls.push(url);
+                }
+            }
+            catch {
+                failedUrls.push(url);
+            }
+        }
+        const summary = `🖼️ Images for comment ${commentId}: ${imageContents.length} of ${c.imageUrls.length} loaded successfully${failedUrls.length > 0 ? ` (${failedUrls.length} failed)` : ""}`;
+        return {
+            content: [
+                { type: "text", text: summary },
+                ...imageContents,
+            ],
+            structuredContent: { found: true, imageCount: imageContents.length },
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Error fetching images: ${message}` }],
+            structuredContent: { found: false, imageCount: 0 },
+            isError: true,
+        };
+    }
+});
+// Tool 4: Mark feedback as resolved
 server.registerTool("mark_feedback_resolved", {
     title: "Mark Feedback Resolved",
     description: `Marks a feedback comment as resolved after you've fixed the issue.
@@ -277,7 +358,7 @@ async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     // Log to stderr so it doesn't interfere with MCP protocol on stdout
-    console.error("Super Feedback MCP server running...");
+    console.error("SuperFeedback MCP server running...");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "super-feedback-mcp",
-  "version": "0.2.2",
-  "description": "MCP server for Super Feedback - enables AI agents to query and resolve client feedback",
+  "version": "0.2.6",
+  "description": "MCP server for SuperFeedback - enables AI agents to query and resolve client feedback",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/index.ts

@@ -72,6 +72,7 @@ interface FullCommentDetails {
     elementText: string;
     label?: string;
   }>;
+  imageUrls?: string[];
 }
 
 // Configuration from environment
@@ -115,7 +116,7 @@ async function callConvexAPI<T>(endpoint: string, options?: RequestInit): Promis
 // Create MCP server
 const server = new McpServer({
   name: "super-feedback",
-  version: "0.2.2",
+  version: "0.2.6",
 });
 
 // Tool 1: Get feedback summary (lightweight overview)
@@ -225,8 +226,10 @@ Returns everything needed to work on the feedback:
 - All replies/thread history
 - Design suggestions (if any)
 - Cross-element references (if any)
+- Image attachment count (if any)
 
-Use this after get_feedback_summary to dive into a specific comment.`,
+Use this after get_feedback_summary to dive into a specific comment.
+If the comment has attached images, use get_comment_images to fetch and view them.`,
     inputSchema: {
       commentId: z.string().describe("The comment ID to get full details for"),
     },
@@ -309,6 +312,11 @@ Use this after get_feedback_summary to dive into a specific comment.`,
         });
       }
 
+      // Note if there are images attached (use get_comment_images to fetch them)
+      if (c.imageUrls && c.imageUrls.length > 0) {
+        text += `\n\n🖼️ Attached Images: ${c.imageUrls.length} image(s) - use get_comment_images("${c.id}") to view`;
+      }
+
       return {
         content: [{ type: "text", text }],
         structuredContent: { found: true, comment: c },
@@ -324,7 +332,94 @@ Use this after get_feedback_summary to dive into a specific comment.`,
   }
 );
 
-// Tool 3: Mark feedback as resolved
+// Tool 3: Get images attached to a comment
+server.registerTool(
+  "get_comment_images",
+  {
+    title: "Get Comment Images",
+    description: `Fetches and returns the images attached to a feedback comment.
+
+Use this when:
+- get_comment_details indicates a comment has attached images
+- You need to see visual context for the feedback (screenshots, mockups, etc.)
+- The user's feedback references something visual
+
+Returns the images as viewable content. Call this after get_comment_details 
+if you need to see the attached images.`,
+    inputSchema: {
+      commentId: z.string().describe("The comment ID to fetch images for"),
+    },
+    outputSchema: {
+      found: z.boolean(),
+      imageCount: z.number(),
+    },
+  },
+  async ({ commentId }) => {
+    try {
+      const params = getAuthParams();
+      params.set("commentId", commentId);
+      
+      const response = await callConvexAPI<{ found: boolean; comment: FullCommentDetails | null }>(
+        `/api/feedback/ai/comment?${params.toString()}`
+      );
+      
+      if (!response.found || !response.comment) {
+        return {
+          content: [{ type: "text", text: `Comment ${commentId} not found` }],
+          structuredContent: { found: false, imageCount: 0 },
+        };
+      }
+      
+      const c = response.comment;
+      
+      if (!c.imageUrls || c.imageUrls.length === 0) {
+        return {
+          content: [{ type: "text", text: `No images attached to comment ${commentId}` }],
+          structuredContent: { found: true, imageCount: 0 },
+        };
+      }
+
+      // Fetch images and convert to base64 for MCP ImageContent
+      const imageContents: Array<{ type: "image"; data: string; mimeType: string }> = [];
+      const failedUrls: string[] = [];
+      
+      for (const url of c.imageUrls) {
+        try {
+          const imgResponse = await fetch(url);
+          if (imgResponse.ok) {
+            const buffer = await imgResponse.arrayBuffer();
+            const base64 = Buffer.from(buffer).toString("base64");
+            const mimeType = imgResponse.headers.get("content-type") || "image/png";
+            imageContents.push({ type: "image", data: base64, mimeType });
+          } else {
+            failedUrls.push(url);
+          }
+        } catch {
+          failedUrls.push(url);
+        }
+      }
+
+      const summary = `🖼️ Images for comment ${commentId}: ${imageContents.length} of ${c.imageUrls.length} loaded successfully${failedUrls.length > 0 ? ` (${failedUrls.length} failed)` : ""}`;
+
+      return {
+        content: [
+          { type: "text", text: summary },
+          ...imageContents,
+        ],
+        structuredContent: { found: true, imageCount: imageContents.length },
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return {
+        content: [{ type: "text", text: `Error fetching images: ${message}` }],
+        structuredContent: { found: false, imageCount: 0 },
+        isError: true,
+      };
+    }
+  }
+);
+
+// Tool 4: Mark feedback as resolved
 server.registerTool(
   "mark_feedback_resolved",
   {
@@ -388,7 +483,7 @@ async function main() {
   await server.connect(transport);
   
   // Log to stderr so it doesn't interfere with MCP protocol on stdout
-  console.error("Super Feedback MCP server running...");
+  console.error("SuperFeedback MCP server running...");
 }
 
 main().catch((error) => {