@gripforgeai/mcp 0.1.25 → 0.1.26

package/dist/attach-options.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export function createPropGripSchema(factory = z) {
+    const Z = factory;
+    const vector = Z.tuple([Z.number().finite(), Z.number().finite(), Z.number().finite()]);
+    return Z.object({
+        position: vector.describe('Grip point in the prop scene local coordinates'),
+        axis: vector.describe('Handle direction / shield top (+Y of the grip frame)'),
+        normal: vector.describe('Blade flat / outward shield face (+Z of the grip frame)'),
+    }).describe('Exact prop grip frame; overrides geometric guesses. A gf_grip locator can supply the same frame.');
+}
+export const propGripSchema = createPropGripSchema();

package/dist/server.js

@@ -12,6 +12,7 @@ import { basename, dirname, extname, join, resolve } from 'node:path';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
+import { propGripSchema } from './attach-options.js';
 import { registerVfxProjectTools } from './vfx-project-tools.js';
 import { registerSceneTools } from './scene-tools.js';
 import { registerServerTools } from './server-tools.js';
@@ -84,6 +85,10 @@ server.tool('gripforge_attach', 'Attach a prop (sword, shield, gun, staff/scythe
     style: z.enum(['melee', 'gun', 'shield', 'staff']).optional().describe('Grip style (default: guessed from the filename)'),
     hand: z.enum(['right', 'left']).optional().describe('Hand side (default right)'),
     height_ratio: z.number().min(0.05).max(1.5).optional().describe('Prop size as a fraction of body height'),
+    prop_grip: propGripSchema.optional(),
+    style_2: z.enum(['melee', 'gun', 'shield', 'staff']).optional().describe('Style of the second held item'),
+    height_ratio_2: z.number().min(0.05).max(1.5).optional(),
+    prop_grip_2: propGripSchema.optional(),
     fist: z.number().min(0).max(1).optional().describe('Fist closing amount, 0 open → 1 closed (default 1)'),
     grip_offset: z
         .array(z.number())
@@ -100,7 +105,7 @@ server.tool('gripforge_attach', 'Attach a prop (sword, shield, gun, staff/scythe
         .describe('Bake character + closed fist + prop into one attached.glb (requires out_dir; .glb/.gltf inputs only). ' +
         'Use this for mitten-hand rigs: the closed fist cannot travel in the bind JSON.'),
     out_dir: z.string().optional().describe('Write bind.json + engine snippets into this folder'),
-}, async ({ character_path, prop_path, character_id, attach_id, prop_id, prop_id_2, prop_path_2, style, hand, height_ratio, fist, grip_offset, ai_refine, export_glb, out_dir }) => {
+}, async ({ character_path, prop_path, character_id, attach_id, prop_id, prop_id_2, prop_path_2, style, hand, height_ratio, prop_grip, style_2, height_ratio_2, prop_grip_2, fist, grip_offset, ai_refine, export_glb, out_dir }) => {
     if (!API_KEY) {
         return err('GRIPFORGE_API_KEY missing. Create a free account at ' +
             API_URL +
@@ -148,6 +153,8 @@ server.tool('gripforge_attach', 'Attach a prop (sword, shield, gun, staff/scythe
         form.append('hand', hand);
     if (height_ratio != null)
         form.append('ratio', String(height_ratio));
+    if (prop_grip)
+        form.append('prop_grip', JSON.stringify(prop_grip));
     if (fist != null)
         form.append('fist', String(fist));
     if (grip_offset)
@@ -195,6 +202,12 @@ server.tool('gripforge_attach', 'Attach a prop (sword, shield, gun, staff/scythe
         form2.append('export', 'glb');
         form2.append('fingers', '1');
         form2.append('hand', hand === 'left' ? 'right' : 'left');
+        if (style_2)
+            form2.append('style', style_2);
+        if (height_ratio_2 != null)
+            form2.append('ratio', String(height_ratio_2));
+        if (prop_grip_2)
+            form2.append('prop_grip', JSON.stringify(prop_grip_2));
         const res2 = await fetch(`${API_URL}/api/v1/attach`, {
             method: 'POST',
             headers: apiHeaders(),
@@ -1300,6 +1313,8 @@ server.tool('gripforge_loadout', 'Build a multi-weapon character in ONE call: at
         prop_id: z.string(),
         hand: z.enum(['left', 'right']).optional(),
         style: z.enum(['melee', 'gun', 'shield', 'staff']).optional(),
+        height_ratio: z.number().min(.05).max(1.5).optional(),
+        prop_grip: propGripSchema.optional(),
     })))
         .describe('set name → props to hold in that set'),
     default_set: z.string().optional().describe('Set visible by default (first set otherwise)'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gripforgeai/mcp",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "The tools your AI needs to make your games. Turn prompts into production-ready game assets \u2014 animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs \u2014 and playable game kits Unity, Godot, Unreal or Three.js can load.",
   "license": "MIT",
   "type": "module",