super-feedback-mcp 0.2.1 → 0.2.5

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.1",
+    version: "0.2.5",
 });
 // Tool 1: Get feedback summary (lightweight overview)
 server.registerTool("get_feedback_summary", {
@@ -50,7 +50,13 @@ Returns:
 - Total comment count
 - Open (unresolved) count  
 - Resolved count
-- List of comment IDs with brief info (feedback text, status, page path)
+- List of comments with index, ID, feedback text, status, and page path
+
+Comments are sorted by createdAt ASCENDING (oldest first), so:
+- Index 1 = the FIRST/OLDEST comment added
+- Index N = the NEWEST/most recent comment
+
+This matches the order users see comments in the UI, so when a user says "fix comment #3", you can use index 3 to find the exact comment they're referring to.
 
 Use this first to understand what feedback exists, then use get_comment_details for full context on specific comments.`,
     inputSchema: {
@@ -201,8 +207,33 @@ 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
+        if (c.imageUrls && c.imageUrls.length > 0) {
+            text += `\n\n🖼️ Attached Images: ${c.imageUrls.length} image(s)`;
+        }
+        // Fetch images and convert to base64 for MCP ImageContent
+        const imageContents = [];
+        if (c.imageUrls && c.imageUrls.length > 0) {
+            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 });
+                    }
+                }
+                catch {
+                    // Skip images that fail to fetch
+                }
+            }
+        }
         return {
-            content: [{ type: "text", text }],
+            content: [
+                { type: "text", text },
+                ...imageContents,
+            ],
             structuredContent: { found: true, comment: c },
         };
     }
@@ -271,7 +302,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.1",
-  "description": "MCP server for Super Feedback - enables AI agents to query and resolve client feedback",
+  "version": "0.2.5",
+  "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.1",
+  version: "0.2.5",
 });
 
 // Tool 1: Get feedback summary (lightweight overview)
@@ -129,7 +130,13 @@ Returns:
 - Total comment count
 - Open (unresolved) count  
 - Resolved count
-- List of comment IDs with brief info (feedback text, status, page path)
+- List of comments with index, ID, feedback text, status, and page path
+
+Comments are sorted by createdAt ASCENDING (oldest first), so:
+- Index 1 = the FIRST/OLDEST comment added
+- Index N = the NEWEST/most recent comment
+
+This matches the order users see comments in the UI, so when a user says "fix comment #3", you can use index 3 to find the exact comment they're referring to.
 
 Use this first to understand what feedback exists, then use get_comment_details for full context on specific comments.`,
     inputSchema: {
@@ -303,8 +310,34 @@ Use this after get_feedback_summary to dive into a specific comment.`,
         });
       }
 
+      // Note if there are images attached
+      if (c.imageUrls && c.imageUrls.length > 0) {
+        text += `\n\n🖼️ Attached Images: ${c.imageUrls.length} image(s)`;
+      }
+
+      // Fetch images and convert to base64 for MCP ImageContent
+      const imageContents: Array<{ type: "image"; data: string; mimeType: string }> = [];
+      if (c.imageUrls && c.imageUrls.length > 0) {
+        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 });
+            }
+          } catch {
+            // Skip images that fail to fetch
+          }
+        }
+      }
+
       return {
-        content: [{ type: "text", text }],
+        content: [
+          { type: "text", text },
+          ...imageContents,
+        ],
         structuredContent: { found: true, comment: c },
       };
     } catch (error) {
@@ -382,7 +415,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) => {