@bifocal/mcp 0.1.2 → 0.1.4

package/dist/bifocalClient.js

@@ -17,9 +17,22 @@ async function get(path) {
     }
     return response.json();
 }
+export async function generateSolution(projectId, insightIds, prototypeId, goal, constraints) {
+    const response = await fetch(`${API_URL}/api/projects/${projectId}/solutions/generate`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ insightIds, prototypeId, goal, constraints }),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({}));
+        throw new Error(error.error || `Request failed: ${response.status}`);
+    }
+    const data = await response.json();
+    return { solution_id: data.solution_id, status: 'generating' };
+}
 export async function updateProject(projectId, updates) {
-    const response = await fetch(`${API_URL}/api/projects/${projectId}`, {
-        method: 'PATCH',
+    const response = await fetch(`${API_URL}/api/projects/${projectId}/update`, {
+        method: 'POST',
         headers: headers(),
         body: JSON.stringify(updates),
     });
@@ -70,6 +83,17 @@ export async function getPrototype(projectId, prototypeId) {
 export async function exportPrototype(projectId, prototypeId) {
     return get(`/api/projects/${projectId}/prototypes/${prototypeId}/download-zip`);
 }
+export async function generatePrototype(projectId, solutionId) {
+    const response = await fetch(`${API_URL}/api/projects/${projectId}/solutions/${solutionId}/generate-prototype`, {
+        method: 'POST',
+        headers: headers(),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({}));
+        throw new Error(error.error || `Request failed: ${response.status}`);
+    }
+    return response.json();
+}
 export async function importPrototypeUploadUrl(projectId, prototypeName, filename) {
     const response = await fetch(`${API_URL}/api/projects/${projectId}/prototypes/import/upload-url`, {
         method: 'POST',
@@ -82,6 +106,18 @@ export async function importPrototypeUploadUrl(projectId, prototypeName, filenam
     }
     return response.json();
 }
+export async function addFeedbackText(projectId, prototypeId, transcript, sessionName) {
+    const response = await fetch(`${API_URL}/api/projects/${projectId}/feedback`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ prototype_id: prototypeId, transcript, session_name: sessionName }),
+    });
+    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',

package/dist/index.js

@@ -2,7 +2,7 @@
 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, importPrototypeUploadUrl, importPrototypeConfirm, getInsights, getQuotes, getSolutions, getSolution, getPrototypes, getPrototype, exportPrototype } from './bifocalClient.js';
+import { createProject, updateProject, listProjects, importPrototypeUploadUrl, importPrototypeConfirm, addFeedbackText, generateSolution, getInsights, getQuotes, getSolutions, getSolution, getPrototypes, getPrototype, exportPrototype, generatePrototype } from './bifocalClient.js';
 import { writeFile } from 'fs/promises';
 import { join } from 'path';
 const server = new Server({ name: 'bifocal', version: '0.1.0' }, { capabilities: { tools: {} } });
@@ -21,6 +21,20 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ['project_id', 'prototype_name', 'zip_path'],
             },
         },
+        {
+            name: 'add_feedback',
+            description: 'Add feedback to a Bifocal project. Accepts plain text or a path to a PDF file. Text is submitted directly; PDFs are parsed and text extracted before submitting.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    project_id: { type: 'string', description: 'The ID of the project.' },
+                    prototype_id: { type: 'string', description: 'The ID of the prototype the feedback is about.' },
+                    source: { type: 'string', description: 'The feedback content — either plain text or a local path to a PDF file.' },
+                    session_name: { type: 'string', description: 'Optional name for the feedback session.' },
+                },
+                required: ['project_id', 'prototype_id', 'source'],
+            },
+        },
         {
             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.',
@@ -89,6 +103,21 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ['project_id', 'insight_id'],
             },
         },
+        {
+            name: 'generate_solution',
+            description: 'Generate a new solution for a project based on selected insights. Before calling this tool, always: (1) call get_insights to show the user the available insights, (2) ask the user which insights they want to prioritize, (3) ask if they have a specific goal or any constraints for the solution. Only call this tool once you have that input. This is async — use get_solutions to check when the solution appears.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    project_id: { type: 'string', description: 'The ID of the project.' },
+                    insight_ids: { type: 'array', items: { type: 'string' }, description: 'IDs of insights to base the solution on. Use get_insights to find them.' },
+                    prototype_id: { type: 'string', description: 'The ID of the prototype to use as context for the solution.' },
+                    goal: { type: 'string', description: 'Optional goal or focus for the solution.' },
+                    constraints: { type: 'string', description: 'Optional constraints to consider.' },
+                },
+                required: ['project_id', 'insight_ids', 'prototype_id'],
+            },
+        },
         {
             name: 'get_solutions',
             description: 'Get all solutions for a Bifocal project. Returns title, brief, barriers addressed, and prototype link (if one was generated) for each solution.',
@@ -112,6 +141,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ['project_id', 'solution_id'],
             },
         },
+        {
+            name: 'generate_prototype',
+            description: 'Generate a prototype from a solution. This queues an async build — call get_prototype with the returned prototype_id to check when status changes to "ready". If a prototype already exists for the solution, returns it immediately.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    project_id: { type: 'string', description: 'The ID of the project.' },
+                    solution_id: { type: 'string', description: 'The ID of the solution to generate a prototype from.' },
+                },
+                required: ['project_id', 'solution_id'],
+            },
+        },
         {
             name: 'get_prototypes',
             description: 'List all prototypes for a Bifocal project. Returns name, status, published URL, parent prototype (for iteration chains), and linked solution if any. Ordered oldest to newest.',
@@ -167,7 +208,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const zipBuffer = await readFile(zip_path);
             const uploadResponse = await fetch(uploadResult.upload_url, {
                 method: 'PUT',
-                headers: { 'Content-Type': 'application/zip' },
+                headers: {
+                    'Content-Type': 'application/zip',
+                    'Content-Encoding': 'identity',
+                },
                 body: zipBuffer,
             });
             if (!uploadResponse.ok) {
@@ -184,23 +228,51 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 response.warning = uploadResult.warning;
             return { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] };
         }
+        if (name === 'add_feedback') {
+            const { project_id, prototype_id, source, session_name } = args;
+            const ext = source.split('.').pop()?.toLowerCase() || '';
+            const isFilePath = source.startsWith('/') || source.startsWith('./') || source.startsWith('~');
+            if (isFilePath && ext === 'pdf') {
+                // PDF: extract text and submit as transcript
+                const { readFile } = await import('fs/promises');
+                const pdfBuffer = await readFile(source);
+                const pdfParseModule = await import('pdf-parse');
+                const pdfParse = pdfParseModule.default ?? pdfParseModule;
+                const parsed = await pdfParse(pdfBuffer);
+                const result = await addFeedbackText(project_id, prototype_id, parsed.text, session_name);
+                return { content: [{ type: 'text', text: JSON.stringify({ ...result, note: 'Text extracted from PDF.' }, null, 2) }] };
+            }
+            else {
+                // Plain text
+                const result = await addFeedbackText(project_id, prototype_id, source, session_name);
+                return { content: [{ type: 'text', text: JSON.stringify(result, 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:
+                claudecode: `⚠️ Do not modify any files in the existing codebase. Read existing files to understand the experience, but never edit them. Create all prototype files in a new separate directory.
+
+Bifocal requires a Vite + React single-page app containing only the experience being tested. Follow these steps:
 
-1. Ask: "Is this project built with Next.js or Vite?"
+1. Ask the user: "What specific page or flow do you want to test in Bifocal?" Only include what is needed to render that experience. Remove unrelated pages, routes, and components.
+
+2. 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."
+- Convert to a Vite + React single-page app with react-router-dom. Remove all SSR, API routes, getServerSideProps, and getStaticProps.
+- Verify: run npm run build and fix any errors before continuing.
+- Create a ZIP excluding node_modules, .git, dist, and any .env files or credentials.
 
 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."`,
+- If no: add react-router-dom with each major section as its own route.
+- Verify: run npm run build and fix any errors before continuing.
+- Create a ZIP excluding node_modules, .git, dist, and any .env files or credentials.
+
+3. Replace any API calls or environment variables with hardcoded fixture data. The prototype must work with no backend and no network requests.
+
+4. Stub out external services — auth, feature flags, analytics, payments, real-time connections — with simple no-op replacements.`,
                 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.`,
@@ -209,11 +281,21 @@ Do not manually zip the project files — the Export button handles cleanup auto
 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.
+                other: `⚠️ Do not modify any files in the existing codebase. Read existing files to understand the experience, but never edit them. Create all prototype files in a new separate directory.
+
+Bifocal requires a Vite + React single-page app containing only the experience being tested.
+
+1. Ask the user: "What specific page or flow do you want to test in Bifocal?" Only include what is needed to render that experience. Remove unrelated pages, routes, and components.
+
+2. Your project should have package.json, index.html, and src/ at the root. Next.js is not supported — use Vite. npm run build should output to a dist/ or build/ folder.
+
+3. Replace any API calls or environment variables with hardcoded fixture data. The prototype must work with no backend and no network requests.
 
-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.
+4. Stub out external services — auth, feature flags, analytics, payments, real-time connections — with simple no-op replacements.
 
-Create a ZIP of the project excluding node_modules, .git, dist, and any .env files.`,
+5. Verify: run npm run build and fix any errors before continuing.
+
+6. Create a ZIP excluding node_modules, .git, dist, and any .env files or credentials.`,
             };
             const text = instructions[platform] ?? instructions.other;
             return { content: [{ type: 'text', text }] };
@@ -271,6 +353,14 @@ Create a ZIP of the project excluding node_modules, .git, dist, and any .env fil
             const quotes = await getQuotes(project_id, insight_id);
             return { content: [{ type: 'text', text: JSON.stringify(quotes, null, 2) }] };
         }
+        if (name === 'generate_solution') {
+            const { project_id, insight_ids, prototype_id, goal, constraints } = args;
+            const result = await generateSolution(project_id, insight_ids, prototype_id, goal, constraints);
+            return { content: [{ type: 'text', text: JSON.stringify({
+                            ...result,
+                            message: 'Solution is being generated. Use get_solutions to check when it appears — typically takes 1-2 minutes.',
+                        }, null, 2) }] };
+        }
         if (name === 'get_solutions') {
             const { project_id } = args;
             const solutions = await getSolutions(project_id);
@@ -281,6 +371,11 @@ Create a ZIP of the project excluding node_modules, .git, dist, and any .env fil
             const solution = await getSolution(project_id, solution_id);
             return { content: [{ type: 'text', text: JSON.stringify(solution, null, 2) }] };
         }
+        if (name === 'generate_prototype') {
+            const { project_id, solution_id } = args;
+            const result = await generatePrototype(project_id, solution_id);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
         if (name === 'get_prototypes') {
             const { project_id } = args;
             const prototypes = await getPrototypes(project_id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bifocal/mcp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Bifocal MCP server — access projects, insights, and prototypes from Claude",
   "type": "module",
   "main": "dist/index.js",
@@ -17,10 +17,13 @@
     "prepublishOnly": "tsc"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0"
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/pdf-parse": "^1.1.5",
+    "pdf-parse": "^2.4.5"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.3.2"
-  }
+  },
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
 }