Model Context Protocol

GripForge MCP

Attach weapons & props from any MCP client (Grok, Claude Code, Cursor). Stdio server with 4 tools — same pipeline as the Studio API.

1 · Install

Depuis un terminal dans votre projet, puis relancez la session :

# Claude Code (CLI)
claude mcp add gripforge -e GRIPFORGE_API_KEY=gf_... -- npx -y @gripforgeai/mcp

# ou en JSON (.mcp.json à la racine du projet, versionnable)
{
  "mcpServers": {
    "gripforge": {
      "command": "npx",
      "args": ["-y", "@gripforgeai/mcp"],
      "env": { "GRIPFORGE_API_KEY": "gf_..." }
    }
  }
}

Vérifiez avec claude mcp list — les outils apparaissent comme mcp__gripforge__*.

Votre clé gf_... se trouve sur votre compte (3 attaches gratuites par mois).

2 · Tools

gripforge_attach

Auto bone-attach a prop onto a rigged character. Returns bind JSON + Three / Unity / Godot snippets.

  • character_pathrequired — Absolute path to character mesh (.glb .gltf .fbx .obj)
  • prop_pathrequired — Absolute path to prop mesh
  • styleoptional — melee | gun | shield | staff
  • handoptional — right | left
  • height_ratiooptional — Prop size as fraction of body height
  • fistoptional — Fist closing amount, 0 open → 1 closed
  • export_glboptional — Bake character + fist + prop into attached.glb (mitten rigs)
  • out_diroptional — Write bind.json + snippets to this folder

gripforge_formats

List supported mesh formats, styles, and hands.

3 · Crédits

1 crédit = 1 attache réussie via l'API (POST /api/v1/attach avec X-API-Key) ou via MCP (GRIPFORGE_API_KEY dans l'env du serveur). Quota mensuel selon le plan : Free 3 · Indie 300 · Studio 2000. Quota épuisé → 402. Le Studio local (prévisualisation) est gratuit et illimité — sans clé, l'API tourne en mode local non compté.

# consulter son solde
curl -H "X-API-Key: gf_..." http://localhost:3100/api/v1/credits
→ { plan, used, limit, remaining, period }

4 · Example

gripforge_attach
  character_path: ~/assets/character.glb
  prop_path:      ~/assets/sword.glb
  style:          melee
  hand:           right
  height_ratio:   0.36

5 · Also available