@primeuicom/mcp 0.1.5 → 0.1.7

package/README.md

@@ -1,22 +1,94 @@
-# @primeui/mcp
+# @primeuicom/mcp
 
-PrimeUI MCP server package.
+PrimeUI MCP connects AI agents to PrimeUI so they can discover project pages, create exports, download export artifacts, and automate PrimeUI-powered workflows directly from your coding environment.
 
-## Runtime
+## Purpose and goals
 
-The package uses Studio API v1 with bearer authentication.
+PrimeUI MCP is the integration layer between PrimeUI and MCP-compatible agents.
 
-Required env:
-- `PRIMEUI_API_KEY`
+Core goals:
 
-Optional env:
-- `PRIMEUI_API_BASE_URL`
-  - if set: MCP calls this base URL,
-  - if not set: MCP defaults to `https://app.primeui.com/`.
+- Give agents a reliable way to read PrimeUI project metadata and page inventory.
+- Let agents trigger and monitor PrimeUI exports.
+- Let agents download export bundles into a local workspace for code-level operations.
+- Provide a stable MCP tool contract for PrimeUI workflows.
 
-The API root is normalized to `/api/v1`.
+## Requirements
 
-Example `.mcp.json`:
+- An MCP client that supports `stdio` servers.
+- A working Node.js runtime (the server is launched via `npx`).
+- A valid PrimeUI API key (`PRIMEUI_API_KEY`).
+
+## PrimeUI API KEY
+
+- PrimeUI provides this key together with the exported project.
+- In practice, it is preconfigured in the exported project's `.mcp.json` for the `primeui` server entry.
+
+## Getting started
+
+The setup below works in any MCP client that supports `.mcp.json` with `stdio` command servers (for example: Codex CLI, Cursor, Cline, and other compatible clients).
+
+Create or update `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "primeui": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@primeuicom/mcp@latest"],
+      "env": {
+        "PRIMEUI_API_KEY": "your-primeui-api-key"
+      }
+    }
+  }
+}
+```
+
+Optional environment variables:
+
+- `PRIMEUI_API_BASE_URL`: custom PrimeUI app base URL (default: `https://app.primeui.com/`).
+- `PRIMEUI_PROJECT_ROOT`: absolute path to the target local project root. If omitted, current working directory is used.
+
+Notes:
+
+- API root is normalized to `/api/v1`.
+- Temporary export files are written under `.primeui/temp/`.
+
+## Install in common MCP clients
+
+If your CLI command syntax differs by client version, use the JSON config from Getting started with the same `primeui` server block.
+
+<details>
+<summary>Codex CLI</summary>
+
+Use the Codex MCP add command:
+
+```bash
+codex mcp add primeui -- npx -y @primeuicom/mcp@latest
+```
+
+Then set `PRIMEUI_API_KEY` in the MCP server env for `primeui`.
+
+</details>
+
+<details>
+<summary>Claude Code</summary>
+
+Add the server:
+
+```bash
+claude mcp add primeui -- npx -y @primeuicom/mcp@latest
+```
+
+Then configure server environment variables (at minimum `PRIMEUI_API_KEY`).
+
+</details>
+
+<details>
+<summary>Cursor</summary>
+
+Add the same server config to your Cursor MCP configuration:
 
 ```json
 {
@@ -26,24 +98,104 @@ Example `.mcp.json`:
       "command": "npx",
       "args": ["-y", "@primeuicom/mcp@latest"],
       "env": {
-        "PRIMEUI_API_KEY": "<issued-api-key>"
+        "PRIMEUI_API_KEY": "your-primeui-api-key"
       }
     }
   }
 }
 ```
 
-## Token revocation note
+</details>
 
-API keys embed `ver` (token version). Future revocation/rotation is implemented by incrementing `project_api_access.token_version`.
+<details>
+<summary>VS Code MCP-compatible setup</summary>
 
-## Local dev
+If your setup supports VS Code MCP server registration via CLI:
 
 ```bash
-pnpm --filter @primeui/mcp dev
+code --add-mcp '{"name":"primeui","command":"npx","args":["-y","@primeuicom/mcp@latest"],"env":{"PRIMEUI_API_KEY":"your-primeui-api-key"}}'
 ```
 
+If your setup uses JSON config instead, use the same `.mcp.json` example from Getting started.
+
+</details>
+
+<details>
+<summary>Cline / other JSON-config clients</summary>
+
+Use the same `.mcp.json` server block from Getting started and provide `PRIMEUI_API_KEY`.
+
+</details>
+
+<details>
+<summary>Gemini CLI</summary>
+
+Add PrimeUI MCP:
+
 ```bash
-pnpm inspect
+gemini mcp add primeui npx -y @primeuicom/mcp@latest
+```
+
+Then configure `PRIMEUI_API_KEY` for that server entry.
+
+</details>
+
+<details>
+<summary>Windsurf</summary>
+
+Use the same JSON server configuration shown in Getting started:
+
+```json
+{
+  "mcpServers": {
+    "primeui": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@primeuicom/mcp@latest"],
+      "env": {
+        "PRIMEUI_API_KEY": "your-primeui-api-key"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+## Tools
+
+Available tools:
 
+| Tool | What it does | Input |
+| --- | --- | --- |
+| `primeui_get_project_info` | Returns project metadata and page list, including export readiness and source paths. | none |
+| `primeui_list_exports` | Lists existing exports with ID, status, and creation time. | none |
+| `primeui_create_export` | Starts a new export and returns created export info plus page snapshot. | none |
+| `primeui_download_export` | Downloads and extracts a completed export into `.primeui/temp/exports/<exportId>/`. | `id` (export ID) |
+| `primeui_clear_temp` | Clears `.primeui/temp/` and recreates baseline temp layout. | none |
+
+## Your first prompt
+
+Try this in your MCP-enabled agent:
+
+```text
+Use PrimeUI MCP to get my project info, list pages that are ready to export, then create a new export and tell me which export ID was created.
+```
+
+Next step:
+
+```text
+Download that export with PrimeUI MCP and show me the local extracted projectPath and pagePath for the /pricing page.
 ```
+
+## Runtime behavior
+
+- PrimeUI MCP uses bearer authentication with `PRIMEUI_API_KEY`.
+- If `PRIMEUI_API_BASE_URL` is not set, it uses `https://app.primeui.com/`.
+- Downloaded archives are validated as ZIP payloads before extraction.
+
+## Troubleshooting
+
+- `PRIMEUI_API_KEY is required`: add or fix `PRIMEUI_API_KEY` in MCP server env.
+- `Failed to extract zip`: verify local file permissions and retry.
+- API contract mismatch errors: your client/server versions may be out of sync; update to latest package and verify PrimeUI backend version.

package/dist/instructions.d.ts

@@ -0,0 +1,173 @@
+import { z } from "zod/v3";
+export declare const initialInstructions: string;
+export declare const toolGetProjectInfo: {
+    title: string;
+    description: string;
+    inputSchema: {};
+    outputSchema: {
+        projectId: z.ZodString;
+        projectName: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        pages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            slug: z.ZodString;
+            pageType: z.ZodString;
+            isReadyToExport: z.ZodBoolean;
+            pagePath: z.ZodString;
+            componentsPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            slug: string;
+            pageType: string;
+            isReadyToExport: boolean;
+            pagePath: string;
+            componentsPath: string;
+        }, {
+            id: string;
+            title: string;
+            slug: string;
+            pageType: string;
+            isReadyToExport: boolean;
+            pagePath: string;
+            componentsPath: string;
+        }>, "many">;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare const toolListExports: {
+    title: string;
+    description: string;
+    inputSchema: {};
+    outputSchema: {
+        exports: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<["in_progress", "completed", "failed"]>;
+            createdAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            status: "in_progress" | "completed" | "failed";
+            createdAt: string;
+        }, {
+            id: string;
+            status: "in_progress" | "completed" | "failed";
+            createdAt: string;
+        }>, "many">;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare const toolCreateExport: {
+    title: string;
+    description: string;
+    inputSchema: {};
+    outputSchema: {
+        export: z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<["in_progress", "completed", "failed"]>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            status: "in_progress" | "completed" | "failed";
+        }, {
+            id: string;
+            status: "in_progress" | "completed" | "failed";
+        }>;
+        pages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            slug: z.ZodString;
+            pageType: z.ZodString;
+            isReadyToExport: z.ZodBoolean;
+            pagePath: z.ZodString;
+            componentsPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            slug: string;
+            pageType: string;
+            isReadyToExport: boolean;
+            pagePath: string;
+            componentsPath: string;
+        }, {
+            id: string;
+            title: string;
+            slug: string;
+            pageType: string;
+            isReadyToExport: boolean;
+            pagePath: string;
+            componentsPath: string;
+        }>, "many">;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare const toolDownloadExport: {
+    title: string;
+    description: string;
+    inputSchema: {
+        id: z.ZodString;
+    };
+    outputSchema: {
+        exportId: z.ZodString;
+        projectPath: z.ZodString;
+        pages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            slug: z.ZodString;
+            pageType: z.ZodString;
+            isReadyToExport: z.ZodBoolean;
+            pagePath: z.ZodString;
+            componentsPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            slug: string;
+            pageType: string;
+            isReadyToExport: boolean;
+            pagePath: string;
+            componentsPath: string;
+        }, {
+            id: string;
+            title: string;
+            slug: string;
+            pageType: string;
+            isReadyToExport: boolean;
+            pagePath: string;
+            componentsPath: string;
+        }>, "many">;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare const toolClearTemp: {
+    title: string;
+    description: string;
+    inputSchema: {};
+    outputSchema: {
+        success: z.ZodBoolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};

package/dist/instructions.js

@@ -0,0 +1,252 @@
+import { z } from "zod/v3";
+const pageSchema = z.object({
+    id: z.string().describe("Stable PrimeUI page identifier. Use this to match the same page across tool responses."),
+    title: z.string().describe("Human-readable page title. Show this to the user when confirming which pages to import."),
+    slug: z
+        .string()
+        .describe("PrimeUI route slug, for example '/', '/pricing', '/docs/getting-started'. Use to match user intent."),
+    pageType: z
+        .string()
+        .describe("PrimeUI page type classification (for example landing, docs, pricing, blogIndex, legal)."),
+    isReadyToExport: z
+        .boolean()
+        .describe("True when this page has an active export-ready variant. Only ready pages are expected in export output."),
+    pagePath: z
+        .string()
+        .describe("Relative file path to the page source inside downloaded export root. Copy page code from this exact path."),
+    componentsPath: z
+        .string()
+        .describe("Relative directory path inside downloaded export root where page-level components live. Use as dependency copy start."),
+}).describe("PrimeUI page descriptor used by project and export tools. Paths are always relative to export project root.");
+const exportStatusSchema = z
+    .enum(["in_progress", "completed", "failed"])
+    .describe("Export lifecycle state. Use 'completed' before calling primeui_download_export.");
+const exportItemSchema = z
+    .object({
+    id: z.string().describe("Export identifier. Pass this value to primeui_download_export input.id."),
+    status: exportStatusSchema,
+    createdAt: z.string().describe("Export creation timestamp in ISO-8601 UTC format."),
+})
+    .describe("Single export record from PrimeUI export history.");
+// ============================================================
+// Shared constants
+// ============================================================
+const TRIGGER_PHRASES = [
+    "import page from PrimeUI",
+    "add page from PrimeUI",
+    "sync pages",
+    "pull page",
+    "transfer page",
+    "get page from PrimeUI",
+    "bring page from PrimeUI",
+    "export from PrimeUI",
+].join(", ");
+const WORKFLOW_SUMMARY = `
+WORKFLOW ORDER (always follow this sequence):
+1. primeui_get_project_info -> discover pages, confirm with user
+2. primeui_create_export -> generate export snapshot
+3. primeui_download_export -> download to temp directory
+4. Manually move page code + dependencies into user's project (per page)
+5. Repeat step 4 for each page user wants
+6. primeui_clear_temp -> cleanup temp files
+`.trim();
+// ============================================================
+// Server Instructions (initialInstructions)
+// ============================================================
+export const initialInstructions = `
+PrimeUI MCP enables importing pages from PrimeUI Studio into your local project.
+
+TRIGGER EXAMPLES (semantic intent, not exact phrase matching): ${TRIGGER_PHRASES}
+
+${WORKFLOW_SUMMARY}
+
+CRITICAL RULES FOR PAGE IMPORT:
+- Import is PAGE-BY-PAGE only. Never import the entire project at once.
+- The downloaded export in .primeui/temp/ contains a full standalone Next.js project.
+  Do NOT copy it wholesale.
+- Copy ONLY the target page file and its direct component dependencies.
+- Always use pagePath and componentsPath from tool responses as source of truth for file locations.
+- Trace each page's imports to identify which component folders are needed.
+- Check if components already exist in user's project - merge carefully, don't blindly overwrite.
+- Adjust import paths to match user's project structure.
+- Do NOT copy: package.json, next.config, tailwind.config, layout files, or any project-level config.
+- If merge conflicts arise and cannot be resolved unambiguously, STOP and ask the user to decide.
+`.trim();
+// ============================================================
+// Tool: primeui_get_project_info
+// ============================================================
+export const toolGetProjectInfo = {
+    title: "PrimeUI Project Info",
+    description: `ENTRY POINT for all PrimeUI import operations. Always start here. Returns project metadata and the full list of available pages.
+
+WHEN TO USE: Call this FIRST when user wants to import, add, sync, pull, or transfer a page from PrimeUI. Intent examples (semantic intent, not exact phrase matching): ${TRIGGER_PHRASES}.
+
+AFTER CALLING:
+- If the user already specified which pages they need - verify those pages exist in the project and have isReadyToExport: true. If any requested page is not found or not ready, inform the user immediately.
+- If the user did NOT specify pages - show the available pages list with titles and slugs, and ask which ones they want to import.
+- Import works on a per-page basis, not the entire project at once. The user can request multiple pages, but each will be transferred individually.
+- Only pages with isReadyToExport: true will be included in the export archive. If the user wants a page that is NOT ready, tell them to select an export-ready page variant in PrimeUI Studio first.
+- Once target pages are confirmed, proceed to primeui_create_export.
+
+${WORKFLOW_SUMMARY}`,
+    inputSchema: {},
+    outputSchema: {
+        projectId: z
+            .string()
+            .describe("PrimeUI project identifier associated with the API key and current import session context."),
+        projectName: z.string().describe("Human-readable PrimeUI project name for confirmations in chat."),
+        metadata: z
+            .record(z.unknown())
+            .describe("Additional project metadata from PrimeUI. May include project-description and other context fields."),
+        pages: z
+            .array(pageSchema)
+            .describe("All pages visible for this project context. Filter by user request and isReadyToExport before creating export."),
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+// ============================================================
+// Tool: primeui_list_exports
+// ============================================================
+export const toolListExports = {
+    title: "PrimeUI Export List",
+    description: `Auxiliary tool to list previously created exports with their IDs, statuses, and creation dates. This is NOT the starting point for page import - start with primeui_get_project_info instead.
+
+WHEN TO USE: This is an OPTIONAL helper tool, NOT part of the main import flow. Use it only when:
+- Something went wrong with an export and you need to check its status.
+- The user explicitly references a previous export by date or context.
+- You need to verify whether an export initiated via PrimeUI Studio UI has completed.
+
+Note: exports can be created both through primeui_create_export AND by the user directly in PrimeUI Studio UI. This tool shows all of them.
+
+Do NOT use this tool as a substitute for primeui_create_export. Always create a fresh export unless the user explicitly asks to use a previous one.
+
+${WORKFLOW_SUMMARY}`,
+    inputSchema: {},
+    outputSchema: {
+        exports: z
+            .array(exportItemSchema)
+            .describe("Available exports sorted by API policy. Use item.id to download a specific prior export if user asks."),
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+// ============================================================
+// Tool: primeui_create_export
+// ============================================================
+export const toolCreateExport = {
+    title: "PrimeUI Create Export",
+    description: `Create a new export snapshot from the current PrimeUI project state and wait for completion. Returns export ID and the list of pages included in the export.
+
+WHEN TO USE: Call this AFTER the user has confirmed which pages they want to import via primeui_get_project_info. This tool is REQUIRED before primeui_download_export, unless the user explicitly and directly asked to download a specific previous export.
+
+AFTER CALLING:
+- Verify that the pages the user wants are present in the export result AND have isReadyToExport: true. If a requested page is missing or not ready, inform the user before proceeding.
+- Use the returned export ID to call primeui_download_export.
+
+${WORKFLOW_SUMMARY}`,
+    inputSchema: {},
+    outputSchema: {
+        export: z
+            .object({
+            id: z.string().describe("Freshly created export identifier. Use this as primeui_download_export input.id."),
+            status: exportStatusSchema,
+        })
+            .describe("Created export summary."),
+        pages: z
+            .array(pageSchema)
+            .describe("Page snapshot associated with this export operation. Validate requested pages here before download/import."),
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+};
+// ============================================================
+// Tool: primeui_download_export
+// ============================================================
+export const toolDownloadExport = {
+    title: "PrimeUI Download Export",
+    description: `Download a completed export into .primeui/temp/exports/[exportId]. Downloads and extracts the full export as a standalone Next.js project into the temp directory. This does NOT modify the user's project - files land only in .primeui/temp/.
+
+Do NOT call this as the first step. Requires export ID from primeui_create_export. Start with primeui_get_project_info instead.
+
+WHEN TO USE: Call this AFTER primeui_create_export has returned a completed export. Requires the export ID returned by primeui_create_export (or from primeui_list_exports if the user explicitly requested a previous export).
+
+AFTER DOWNLOAD:
+- The response includes a pages array. Verify the page the user wants is present and was exported successfully.
+- Each page in the response has pagePath and componentsPath fields - use these as direct pointers to locate the page source code and its component dependencies in the downloaded export. No need to search manually.
+
+MANUAL IMPORT STEPS per page (do not skip):
+1. Read the page file at the pagePath from the response.
+2. Read the component files at the componentsPath from the response. Trace the page's imports to identify which specific component folders are needed.
+3. Copy ONLY the page file and its component dependencies into the user's project.
+4. Adjust all import paths to match the user's project structure.
+5. Check for existing components in user's project:
+   - If code overlaps or was modified on the user's side, carefully determine the nature of changes on both sides.
+   - If the merge conflict can be resolved unambiguously - resolve it.
+   - If NOT - STOP, explain the conflict to the user, and ask for their decision before continuing.
+6. Do NOT copy project config files (package.json, next.config, tailwind.config, layout, etc.).
+7. REPEAT steps 1-6 for each page the user wants to import.
+8. Only after ALL pages are successfully imported, call primeui_clear_temp to clean up.
+
+  ${WORKFLOW_SUMMARY}`,
+    inputSchema: {
+        id: z
+            .string()
+            .describe("Export identifier to download. Prefer export.id from primeui_create_export; use primeui_list_exports only on explicit user request."),
+    },
+    outputSchema: {
+        exportId: z
+            .string()
+            .describe("Downloaded export identifier. Should match the requested input.id for traceability."),
+        projectPath: z
+            .string()
+            .describe("Absolute local path to extracted export root in .primeui/temp/exports/[exportId]. Read files from here only."),
+        pages: z
+            .array(pageSchema)
+            .describe("Page descriptors for import decisions. Use pagePath/componentsPath from each item when copying code into user project."),
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+// ============================================================
+// Tool: primeui_clear_temp
+// ============================================================
+export const toolClearTemp = {
+    title: "PrimeUI Clear Temp",
+    description: `Delete all files in .primeui/temp/ and recreate empty temp structure.
+
+Do NOT call this unless ALL requested pages have been successfully imported into the user's project.
+
+WHEN TO USE: Call this as the FINAL step after ALL requested pages have been successfully imported into the user's project. Do not call this between page imports - wait until all pages are done.
+
+Safe to call multiple times. Only affects .primeui/temp/ directory - never touches the user's project files.
+
+${WORKFLOW_SUMMARY}`,
+    inputSchema: {},
+    outputSchema: {
+        success: z.boolean().describe("True when temp cleanup completed and baseline temp structure was recreated."),
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+};
+//# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

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

package/dist/lib/fs.js

@@ -1,8 +1,6 @@
-import { execFile } from "node:child_process";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { promisify } from "node:util";
-const execFileAsync = promisify(execFile);
+import extractZipArchive from "extract-zip";
 export async function ensureDir(dirPath) {
     await mkdir(dirPath, { recursive: true });
 }
@@ -17,11 +15,11 @@ export async function writeUtf8(filePath, content) {
 export async function extractZip(zipPath, targetDir) {
     await ensureDir(targetDir);
     try {
-        await execFileAsync("unzip", ["-o", zipPath, "-d", targetDir]);
+        await extractZipArchive(zipPath, { dir: targetDir });
     }
     catch (error) {
         const details = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to extract zip at "${zipPath}". Ensure "unzip" is installed. ${details}`);
+        throw new Error(`Failed to extract zip at "${zipPath}". ${details}`);
     }
 }
 //# sourceMappingURL=fs.js.map

package/dist/lib/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/lib/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAEzC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAe;IAC5C,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IACvC,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,SAAiB;IACjE,MAAM,SAAS,CAAC,SAAS,CAAC,CAAA;IAE1B,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,mCAAmC,OAAO,EAAE,CAAC,CAAA;IACnG,CAAC;AACH,CAAC"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/lib/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,iBAAiB,MAAM,aAAa,CAAA;AAE3C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAe;IAC5C,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IACvC,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,SAAiB;IACjE,MAAM,SAAS,CAAC,SAAS,CAAC,CAAA;IAE1B,IAAI,CAAC;QACH,MAAM,iBAAiB,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAA;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,MAAM,OAAO,EAAE,CAAC,CAAA;IACtE,CAAC;AACH,CAAC"}

package/dist/server.js

@@ -1,5 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod/v3";
+import { initialInstructions, toolClearTemp, toolCreateExport, toolDownloadExport, toolGetProjectInfo, toolListExports, } from "./instructions.js";
 function okResult(title, data) {
     return {
         content: [{ type: "text", text: `${title} completed` }],
@@ -17,32 +17,10 @@ export function createPrimeUiMcpServer(source) {
     const server = new McpServer({
         name: "primeui-mcp-server",
         version: "0.1.0",
+    }, {
+        instructions: initialInstructions,
     });
-    server.registerTool("primeui_get_project_info", {
-        title: "PrimeUI Project Info",
-        description: "Get current project info for PrimeUI export context.",
-        inputSchema: {},
-        outputSchema: {
-            projectId: z.string(),
-            projectName: z.string(),
-            metadata: z.record(z.unknown()),
-            pages: z.array(z.object({
-                id: z.string(),
-                title: z.string(),
-                slug: z.string(),
-                pageType: z.string(),
-                isReadyToExport: z.boolean(),
-                pagePath: z.string(),
-                componentsPath: z.string(),
-            })),
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async () => {
+    server.registerTool("primeui_get_project_info", toolGetProjectInfo, async () => {
         try {
             const info = await source.getProjectInfo();
             return okResult("primeui_get_project_info", info);
@@ -51,24 +29,7 @@ export function createPrimeUiMcpServer(source) {
             return errorResult(error);
         }
     });
-    server.registerTool("primeui_list_exports", {
-        title: "PrimeUI Export List",
-        description: "List available PrimeUI exports.",
-        inputSchema: {},
-        outputSchema: {
-            exports: z.array(z.object({
-                id: z.string(),
-                status: z.enum(["in_progress", "completed", "failed"]),
-                createdAt: z.string(),
-            })),
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async () => {
+    server.registerTool("primeui_list_exports", toolListExports, async () => {
         try {
             const exportsList = await source.listExports();
             return okResult("primeui_list_exports", { exports: exportsList });
@@ -77,32 +38,7 @@ export function createPrimeUiMcpServer(source) {
             return errorResult(error);
         }
     });
-    server.registerTool("primeui_create_export", {
-        title: "PrimeUI Create Export",
-        description: "Create a new export from the current project state and wait for completion.",
-        inputSchema: {},
-        outputSchema: {
-            export: z.object({
-                id: z.string(),
-                status: z.enum(["in_progress", "completed", "failed"]),
-            }),
-            pages: z.array(z.object({
-                id: z.string(),
-                title: z.string(),
-                slug: z.string(),
-                pageType: z.string(),
-                isReadyToExport: z.boolean(),
-                pagePath: z.string(),
-                componentsPath: z.string(),
-            })),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    }, async () => {
+    server.registerTool("primeui_create_export", toolCreateExport, async () => {
         try {
             const result = await source.createExport();
             return okResult("primeui_create_export", result);
@@ -111,23 +47,7 @@ export function createPrimeUiMcpServer(source) {
             return errorResult(error);
         }
     });
-    server.registerTool("primeui_download_export", {
-        title: "PrimeUI Download Export",
-        description: "Download an export by id into .primeui/temp/exports/[exportId].",
-        inputSchema: {
-            id: z.string().describe("Export id from primeui_list_exports"),
-        },
-        outputSchema: {
-            exportId: z.string(),
-            projectPath: z.string(),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async ({ id }) => {
+    server.registerTool("primeui_download_export", toolDownloadExport, async ({ id }) => {
         try {
             const result = await source.downloadExportById(id);
             return okResult("primeui_download_export", result);
@@ -136,20 +56,7 @@ export function createPrimeUiMcpServer(source) {
             return errorResult(error);
         }
     });
-    server.registerTool("primeui_clear_temp", {
-        title: "PrimeUI Clear Temp",
-        description: "Clear .primeui/temp and recreate baseline temp structure.",
-        inputSchema: {},
-        outputSchema: {
-            success: z.boolean(),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: true,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async () => {
+    server.registerTool("primeui_clear_temp", toolClearTemp, async () => {
         try {
             await source.clearTemp();
             return okResult("primeui_clear_temp", { success: true });

package/dist/server.js.map

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

package/dist/services/project-sync-service.js

@@ -38,9 +38,11 @@ export class ProjectSyncService {
         await this.provider.downloadExportArchive(id, targetZipPath);
         await resetDir(targetProjectPath);
         await extractZip(targetZipPath, targetProjectPath);
+        const { pages } = await this.provider.getProjectInfo();
         return {
             exportId: id,
             projectPath: targetProjectPath,
+            pages,
         };
     }
     async clearTemp() {

package/dist/services/project-sync-service.js.map

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

package/dist/types.d.ts

@@ -29,4 +29,5 @@ export interface PrimeUiCreateExportResult {
 export interface PrimeUiDownloadResult {
     exportId: string;
     projectPath: string;
+    pages: PrimeUiProjectPage[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primeuicom/mcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "type": "module",
   "main": "dist/service.js",
   "bin": {
@@ -20,6 +20,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.3",
+    "extract-zip": "^2.0.1",
     "zod": "^3.25.76"
   },
   "devDependencies": {