@bifocal/mcp 0.1.1 → 0.1.2

package/dist/bifocalClient.js

@@ -70,3 +70,27 @@ export async function getPrototype(projectId, prototypeId) {
 export async function exportPrototype(projectId, prototypeId) {
     return get(`/api/projects/${projectId}/prototypes/${prototypeId}/download-zip`);
 }
+export async function importPrototypeUploadUrl(projectId, prototypeName, filename) {
+    const response = await fetch(`${API_URL}/api/projects/${projectId}/prototypes/import/upload-url`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ prototype_name: prototypeName, filename }),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({}));
+        throw new Error(error.error || `Request failed: ${response.status}`);
+    }
+    return response.json();
+}
+export async function importPrototypeConfirm(projectId, prototypeId, contextId, filename, s3Key, s3Url) {
+    const response = await fetch(`${API_URL}/api/projects/${projectId}/prototypes/import/confirm`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ prototype_id: prototypeId, context_id: contextId, filename, s3_key: s3Key, s3_url: s3Url }),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({}));
+        throw new Error(error.error || `Request failed: ${response.status}`);
+    }
+    return response.json();
+}

package/dist/index.js

@@ -2,12 +2,40 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { createProject, updateProject, listProjects, getInsights, getQuotes, getSolutions, getSolution, getPrototypes, getPrototype, exportPrototype } from './bifocalClient.js';
+import { createProject, updateProject, listProjects, importPrototypeUploadUrl, importPrototypeConfirm, getInsights, getQuotes, getSolutions, getSolution, getPrototypes, getPrototype, exportPrototype } from './bifocalClient.js';
 import { writeFile } from 'fs/promises';
 import { join } from 'path';
 const server = new Server({ name: 'bifocal', version: '0.1.0' }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
+        {
+            name: 'import_prototype',
+            description: 'Import a local zip file as a prototype into a Bifocal project. Always call get_import_instructions first to ensure the zip is correctly prepared.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    project_id: { type: 'string', description: 'The ID of the project to import into.' },
+                    prototype_name: { type: 'string', description: 'A name for the prototype.' },
+                    zip_path: { type: 'string', description: 'Absolute path to the zip file on the local filesystem.' },
+                },
+                required: ['project_id', 'prototype_name', 'zip_path'],
+            },
+        },
+        {
+            name: 'get_import_instructions',
+            description: 'Get platform-specific instructions for preparing a prototype zip file before importing it into Bifocal. Always call this before import_prototype.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    platform: {
+                        type: 'string',
+                        enum: ['claudecode', 'lovable', 'figmamake', 'other'],
+                        description: 'The platform the prototype was built with.',
+                    },
+                },
+                required: ['platform'],
+            },
+        },
         {
             name: 'create_project',
             description: 'Create a new Bifocal project. Before calling this tool, always ask the user if they have a PRD or any context to add for the project.',
@@ -125,6 +153,71 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     try {
+        if (name === 'import_prototype') {
+            const { project_id, prototype_name, zip_path } = args;
+            const filename = zip_path.split('/').pop() || 'prototype.zip';
+            // Step 1: get presigned upload URL
+            const uploadResult = await importPrototypeUploadUrl(project_id, prototype_name, filename);
+            if (uploadResult.warning) {
+                // Surface warning but continue
+                console.warn('[import_prototype]', uploadResult.warning);
+            }
+            // Step 2: read zip and upload to S3
+            const { readFile } = await import('fs/promises');
+            const zipBuffer = await readFile(zip_path);
+            const uploadResponse = await fetch(uploadResult.upload_url, {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/zip' },
+                body: zipBuffer,
+            });
+            if (!uploadResponse.ok) {
+                throw new Error(`Failed to upload zip to S3: ${uploadResponse.status}`);
+            }
+            // Step 3: confirm import and queue processing
+            const confirmResult = await importPrototypeConfirm(project_id, uploadResult.prototype_id, uploadResult.context_id, filename, uploadResult.s3_key, uploadResult.s3_url);
+            const response = {
+                prototype_id: confirmResult.prototype_id,
+                status: confirmResult.status,
+                message: 'Prototype uploaded and queued for processing. It will be ready in a few minutes.',
+            };
+            if (uploadResult.warning)
+                response.warning = uploadResult.warning;
+            return { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] };
+        }
+        if (name === 'get_import_instructions') {
+            const { platform } = args;
+            const instructions = {
+                claudecode: `Bifocal requires a Vite + React single-page app. Follow these steps to prepare your zip:
+
+1. Ask: "Is this project built with Next.js or Vite?"
+
+If Next.js:
+- Run: "Convert this project from Next.js to a Vite + React single-page app with react-router-dom for navigation. Remove all server-side rendering, API routes, and any use of getServerSideProps or getStaticProps. Keep all the UI and logic but make everything client-side only. Each major section of the app should be its own route (e.g. /home, /dashboard, /settings). The build should produce a dist/ folder when you run npm run build."
+- Then verify: "Run npm run build and let me know if it succeeds or if there are any errors." Fix any errors before continuing.
+- Then: "Create a ZIP of the project excluding node_modules, .git, dist, and any .env files."
+
+If Vite:
+- Ask: "Does this project use react-router-dom so that each major section has its own URL path?"
+- If no: "Add react-router-dom to this project. Break the main sections of the UI into separate routes using <BrowserRouter> in main.tsx and <Routes>/<Route> in App.tsx. Each major section should have its own URL path."
+- Verify: "Run npm run build and let me know if it succeeds or if there are any errors." Fix any errors before continuing.
+- Then: "Create a ZIP of the project excluding node_modules, .git, dist, and any .env files."`,
+                lovable: `To export from Lovable: open your project → top-right menu → Export → Download ZIP.
+
+Do not manually zip the project files — the Export button handles cleanup automatically.`,
+                figmamake: `To export from Figma Make:
+1. In Figma Make, go to Prototype Settings → GitHub and push your project to a GitHub repo.
+2. Go to your GitHub repo → click the green Code button → Download ZIP.
+
+Note: Some Figma assets may not convert correctly after export. If your build fails or images are missing, check that all asset paths are correct.`,
+                other: `Bifocal requires a Vite + React project. Next.js is not supported.
+
+Your project should have package.json, index.html, and src/ at the root, and npm run build should output to a dist/ or build/ folder.
+
+Create a ZIP of the project excluding node_modules, .git, dist, and any .env files.`,
+            };
+            const text = instructions[platform] ?? instructions.other;
+            return { content: [{ type: 'text', text }] };
+        }
         if (name === 'update_project') {
             const { project_id, name: projectName, description } = args;
             const project = await updateProject(project_id, { name: projectName, description });
@@ -158,7 +251,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 }
             }
             const project = await createProject(projectName, description);
-            return { content: [{ type: 'text', text: JSON.stringify(project, null, 2) }] };
+            const response = {
+                ...project,
+                next_step: "Ask the user if they have a prototype they'd like to import — projects require one to be useful. If yes, call get_import_instructions first to get platform-specific requirements for preparing the zip, then call import_prototype.",
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] };
         }
         if (name === 'list_projects') {
             const projects = await listProjects();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bifocal/mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Bifocal MCP server — access projects, insights, and prototypes from Claude",
   "type": "module",
   "main": "dist/index.js",