faux-studio 0.3.2 → 0.3.3

package/dist/index.js

@@ -25355,10 +25355,46 @@ async function handleGetBlueprint(blueprintId, jwt2) {
   }
   return { content };
 }
+var INSTRUCTIONS = `You are connected to Figma Desktop via faux-studio. You can create, modify, and inspect designs using the tools below.
+
+## Workflow
+1. Call \`setup_figma\` first to ensure Figma is running and connected.
+2. Call \`get_page_structure\` or \`get_screenshot\` to understand what's on the canvas.
+3. Use \`create_from_schema\` for all creation \u2014 it accepts declarative JSON schemas.
+4. Use \`modify_via_schema\` to change existing nodes.
+5. Use \`get_screenshot\` to verify your work visually.
+
+## Primary Tools
+- **create_from_schema** \u2014 The main creation tool. Pass a JSON schema describing frames, components, text, shapes, auto-layout, and variable bindings. Supports \`@Variable|fallback\` syntax for design tokens, \`$icon\` for icons, \`$image\` for images, \`$textStyle\` for typography, and ComponentSet matrix mode.
+- **modify_via_schema** \u2014 Modify existing nodes by ID. Same schema format as create_from_schema.
+- **execute_figma_script** \u2014 Run raw Figma Plugin API JavaScript when no other tool fits.
+
+## Design Tokens & Variables
+- Call \`get_design_system\` to read existing variables, styles, and tokens before designing.
+- Use \`create_variable_collection\` and \`create_variables\` to set up design tokens.
+- Bind variables in schemas with \`@CollectionName/VariableName|fallback\` syntax.
+
+## Reading the Canvas
+- \`get_page_structure\` \u2014 page/frame hierarchy
+- \`get_node_details\` \u2014 inspect specific nodes by ID
+- \`get_selection\` \u2014 what the user has selected
+- \`query_nodes\` \u2014 search nodes by type, name, or properties
+- \`get_components\` \u2014 list available components
+- \`get_screenshot\` \u2014 visual capture of the canvas
+
+## Best Practices
+- Always read the existing design system before creating new elements.
+- Use auto-layout (horizontal/vertical) for responsive layouts \u2014 avoid absolute positioning.
+- Bind colors, spacing, and typography to variables for maintainability.
+- Group related elements in frames with descriptive names.
+- Create components for reusable UI patterns.`;
 function createMcpServer(deps) {
   const server = new Server(
-    { name: "faux-studio", version: "0.3.2" },
-    { capabilities: { tools: { listChanged: true } } }
+    { name: "faux-studio", version: "0.3.3" },
+    {
+      capabilities: { tools: { listChanged: true } },
+      instructions: INSTRUCTIONS
+    }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => {
     const localTools = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faux-studio",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "AI-powered Figma design via MCP — connect any AI client to Figma Desktop",
   "type": "module",
   "bin": {