uiplug-mcp 1.2.1 → 1.3.0

package/dist/index.js

@@ -40,8 +40,9 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         {
             name: "list_components",
             description: "List published UI components from the UIPlug marketplace. " +
-                "Optionally filter by framework (e.g. React, Vue, Jetpack Compose, Flutter, SwiftUI) " +
-                "and/or category (e.g. Layout, Navigation, Input, Data Display, Feedback, Sensors).",
+                "Optionally filter by framework, category, or group_slug. " +
+                "When group_slug is set, returns all components in that group (including private ones if you are a member). " +
+                "Use list_groups to find your group slugs.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -58,13 +59,20 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         type: "number",
                         description: "Maximum number of results to return (default 20, max 50).",
                     },
+                    group_slug: {
+                        type: "string",
+                        description: "Filter to a specific group (e.g. 'acme-ui-team'). " +
+                            "Members of the group will also see private components. " +
+                            "Use list_groups to find your group slugs.",
+                    },
                 },
             },
         },
         {
             name: "search_components",
             description: "Search UIPlug components by name, description, or tag. " +
-                "Returns matching components with a summary of their metadata.",
+                "Returns matching components with a summary of their metadata. " +
+                "To search within a specific group (including private components), provide group_slug.",
             inputSchema: {
                 type: "object",
                 required: ["query"],
@@ -77,6 +85,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         type: "string",
                         description: "Narrow results to a specific framework.",
                     },
+                    group_slug: {
+                        type: "string",
+                        description: "Narrow results to a specific group. " +
+                            "Members of the group will also see private components.",
+                    },
                 },
             },
         },
@@ -96,11 +109,28 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 },
             },
         },
+        {
+            name: "list_groups",
+            description: "List the UIPlug groups you are an active member of. " +
+                "Returns each group's name and slug. Use the slug in create_component to submit a component on behalf of a group.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
         {
             name: "create_component",
             description: "Submit a new UI component to the UIPlug marketplace. " +
                 "The component will be submitted for review (status: pending) and visible in your dashboard at uiplug.com/dashboard/components. " +
-                "Use this after building a component to share it with the community.",
+                "Use this after building a component to share it with the community. " +
+                "To submit on behalf of a group, provide group_slug (use list_groups to find it). " +
+                "Group components can be public (visible to everyone) or private (visible only to group members). " +
+                "IMPORTANT — code quality standard: the code field must be a complete, self-contained file. " +
+                "It must start with all necessary imports (e.g. import { useState } from 'react'), " +
+                "contain the full component implementation (not just a snippet or function body), " +
+                "support common props like size, variant, disabled, loading, onClick, children, and icon where relevant, " +
+                "and end with a default export (e.g. export default MyComponent). " +
+                "Do NOT submit partial snippets, TypeScript-only interfaces without implementation, or placeholder code.",
             inputSchema: {
                 type: "object",
                 required: ["name", "description", "framework", "category", "code"],
@@ -124,7 +154,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     },
                     code: {
                         type: "string",
-                        description: "Full component source code.",
+                        description: "Complete, self-contained component source code. " +
+                            "Must include: (1) all imports at the top, (2) full component with props and logic, " +
+                            "(3) export default at the bottom. " +
+                            "Example structure for React: " +
+                            "import { useState } from 'react'; " +
+                            "const MyComponent = ({ size = 'md', disabled = false, onClick, children }) => { ... }; " +
+                            "export default MyComponent;",
                     },
                     installation: {
                         type: "string",
@@ -139,6 +175,21 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         type: "string",
                         description: "Optional — AI model used to build this (e.g. 'Claude Sonnet 4.6').",
                     },
+                    group_slug: {
+                        type: "string",
+                        description: "Optional — submit this component on behalf of a group. " +
+                            "Use the slug from list_groups (e.g. 'acme-ui-team'). " +
+                            "The component will go to the group admin for review. " +
+                            "You must be an active member of the group.",
+                    },
+                    visibility: {
+                        type: "string",
+                        enum: ["public", "private"],
+                        description: "Only relevant when group_slug is set. " +
+                            "'public' = visible to everyone in Explore (default). " +
+                            "'private' = visible only to group members. " +
+                            "Personal components (no group_slug) are always public.",
+                    },
                 },
             },
         },
@@ -154,44 +205,64 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     }
     // ── list_components ─────────────────────────────────────────────────────────
     if (name === "list_components") {
-        const { framework, category, limit = 20 } = (args ?? {});
-        let query = supabase
-            .from("components")
-            .select("id, name, description, category, framework, downloads, likes, model, " +
-            "profiles!components_author_id_fkey(username)")
-            .eq("status", "published")
-            .order("downloads", { ascending: false })
-            .limit(Math.min(limit, 50));
-        if (framework)
-            query = query.eq("framework", framework);
-        if (category)
-            query = query.eq("category", category);
-        const { data, error } = await query;
-        if (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        const { framework, category, limit = 20, group_slug } = (args ?? {});
+        let rows = [];
+        if (group_slug) {
+            // Use SECURITY DEFINER RPC so private group components are visible to members
+            const { createHash: ch } = await import("crypto");
+            const kh = ch("sha256").update(process.env.UIPLUG_API_KEY ?? "").digest("hex");
+            const { data, error } = await supabase.rpc("get_group_components", {
+                p_key_hash: kh,
+                p_group_slug: group_slug,
+                p_search: null,
+                p_limit: Math.min(limit, 50),
+            });
+            if (error) {
+                return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+            }
+            rows = (data ?? []).filter((c) => (!framework || c.framework === framework) &&
+                (!category || c.category === category));
+        }
+        else {
+            let query = supabase
+                .from("components")
+                .select("id, name, description, category, framework, downloads, likes, model, status, visibility, " +
+                "profiles!components_author_id_fkey(username)")
+                .eq("status", "published")
+                .eq("visibility", "public")
+                .order("downloads", { ascending: false })
+                .limit(Math.min(limit, 50));
+            if (framework)
+                query = query.eq("framework", framework);
+            if (category)
+                query = query.eq("category", category);
+            const { data, error } = await query;
+            if (error) {
+                return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+            }
+            rows = (data ?? []).map((c) => ({ ...c, author: c.profiles?.username ?? "Unknown" }));
+        }
+        if (rows.length === 0) {
+            return {
+                content: [{ type: "text", text: group_slug ? `No components found in group "${group_slug}".` : "No components found." }],
+            };
         }
-        const rows = (data ?? []).map((c) => ({
-            id: c.id,
-            name: c.name,
-            description: c.description,
-            category: c.category,
-            framework: c.framework,
-            author: c.profiles?.username ?? "Unknown",
-            downloads: c.downloads ?? 0,
-            likes: c.likes ?? 0,
-            model: c.model ?? null,
-        }));
         return {
             content: [
                 {
                     type: "text",
-                    text: `Found ${rows.length} component(s).\n\n` +
+                    text: `Found ${rows.length} component(s)${group_slug ? ` in group "${group_slug}"` : ""}.\n\n` +
                         rows
-                            .map((c) => `**${c.name}** (${c.framework} · ${c.category})\n` +
-                            `  ID: ${c.id}\n` +
-                            `  ${c.description}\n` +
-                            `  Author: ${c.author} · ↓${c.downloads} ♥${c.likes}` +
-                            (c.model ? ` · Built with ${c.model}` : ""))
+                            .map((c) => {
+                            const author = c.author ?? c.author_username ?? "Unknown";
+                            const visTag = c.visibility === "private" ? " 🔒" : "";
+                            const statusTag = c.status !== "published" ? ` [${c.status}]` : "";
+                            return (`**${c.name}**${visTag}${statusTag} (${c.framework} · ${c.category})\n` +
+                                `  ID: ${c.id}\n` +
+                                `  ${c.description}\n` +
+                                `  Author: ${author} · ↓${c.downloads ?? 0} ♥${c.likes ?? 0}` +
+                                (c.model ? ` · Built with ${c.model}` : ""));
+                        })
                             .join("\n\n"),
                 },
             ],
@@ -199,13 +270,44 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     }
     // ── search_components ───────────────────────────────────────────────────────
     if (name === "search_components") {
-        const { query: q, framework } = (args ?? {});
+        const { query: q, framework, group_slug } = (args ?? {});
+        // Group-scoped search (includes private components for members)
+        if (group_slug) {
+            const { createHash: ch } = await import("crypto");
+            const kh = ch("sha256").update(process.env.UIPLUG_API_KEY ?? "").digest("hex");
+            const { data, error } = await supabase.rpc("get_group_components", {
+                p_key_hash: kh,
+                p_group_slug: group_slug,
+                p_search: q,
+                p_limit: 30,
+            });
+            if (error) {
+                return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+            }
+            const results = (data ?? []).filter((c) => !framework || c.framework === framework);
+            if (results.length === 0) {
+                return { content: [{ type: "text", text: `No components found in group "${group_slug}" matching "${q}".` }] };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `Found ${results.length} result(s) in group "${group_slug}" for "${q}":\n\n` +
+                            results.map((c) => {
+                                const visTag = c.visibility === "private" ? " 🔒" : "";
+                                const statusTag = c.status !== "published" ? ` [${c.status}]` : "";
+                                return (`**${c.name}**${visTag}${statusTag} (${c.framework} · ${c.category})\n` +
+                                    `  ID: ${c.id}\n  ${c.description}\n  Author: ${c.author_username ?? "Unknown"}`);
+                            }).join("\n\n"),
+                    }],
+            };
+        }
         // Search name + description via ilike, then also fetch tag matches
         let nameQuery = supabase
             .from("components")
             .select("id, name, description, category, framework, downloads, likes, " +
             "profiles!components_author_id_fkey(username)")
             .eq("status", "published")
+            .eq("visibility", "public")
             .or(`name.ilike.%${q}%,description.ilike.%${q}%`)
             .order("downloads", { ascending: false })
             .limit(20);
@@ -239,6 +341,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 .select("id, name, description, category, framework, downloads, likes, " +
                 "profiles!components_author_id_fkey(username)")
                 .eq("status", "published")
+                .eq("visibility", "public")
                 .in("id", newTagIds)
                 .limit(10);
             if (framework)
@@ -328,9 +431,42 @@ ${c.code_component}
 `;
         return { content: [{ type: "text", text: output }] };
     }
+    // ── list_groups ─────────────────────────────────────────────────────────────
+    if (name === "list_groups") {
+        const { createHash: ch } = await import("crypto");
+        const kh = ch("sha256").update(process.env.UIPLUG_API_KEY ?? "").digest("hex");
+        const { data, error } = await supabase.rpc("list_user_groups", { p_key_hash: kh });
+        if (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+        const groups = (data ?? []);
+        if (groups.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "You are not a member of any groups yet.\n\n" +
+                            "Create or join a group at: https://uiplug.com/dashboard/groups",
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `You are a member of ${groups.length} group(s):\n\n` +
+                        groups
+                            .map((g) => `**${g.group_name}** (slug: \`${g.group_slug}\`) — ${g.role}`)
+                            .join("\n") +
+                        `\n\nUse the slug in create_component to submit components on behalf of a group.`,
+                },
+            ],
+        };
+    }
     // ── create_component ────────────────────────────────────────────────────────
     if (name === "create_component") {
-        const { name: compName, description, framework, category, code, installation, tags, model, } = (args ?? {});
+        const { name: compName, description, framework, category, code, installation, tags, model, group_slug, visibility = "public", } = (args ?? {});
         const { createHash: createHash2 } = await import("crypto");
         const keyHashForCreate = createHash2("sha256").update(process.env.UIPLUG_API_KEY ?? "").digest("hex");
         const { data: componentId, error } = await supabase.rpc("create_component", {
@@ -343,10 +479,16 @@ ${c.code_component}
             p_installation: installation ?? null,
             p_tags: tags ?? [],
             p_model: model ?? null,
+            p_group_slug: group_slug ?? null,
+            p_visibility: group_slug ? (visibility ?? "public") : "public",
         });
         if (error) {
             return { content: [{ type: "text", text: `Error submitting component: ${error.message}` }], isError: true };
         }
+        const groupNote = group_slug
+            ? `\n**Group:** ${group_slug} (${visibility === "private" ? "🔒 Private — visible to group members only" : "🌐 Public — visible to everyone"})\n` +
+                `The group admin will review it at: https://uiplug.com/dashboard/groups`
+            : "";
         return {
             content: [
                 {
@@ -355,7 +497,8 @@ ${c.code_component}
                         `**Name:** ${compName}\n` +
                         `**Framework:** ${framework}\n` +
                         `**Category:** ${category}\n` +
-                        `**ID:** ${componentId}\n\n` +
+                        `**ID:** ${componentId}\n` +
+                        groupNote + `\n` +
                         `View and manage it at: https://uiplug.com/dashboard/components`,
                 },
             ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uiplug-mcp",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "MCP server for UIPlug — gives AI agents access to the UIPlug UI component marketplace",
   "type": "module",
   "bin": {