@gripforgeai/mcp

中文文档
0.1.167发布于 2026/11/14MITES Module构建来源已验证近 30 天下载 1.9万

你的人工智能需要制作游戏的工具 将提示转换为制作准备的游戏资产——带有武器附加的动画角色,无缝纹理,地形,VFX,HUD等,并为GripForge玩家,Unity,Godot和Unrea共同创建游戏

中文使用文档
文档目录13 节
  1. 如何使用
  2. 主要特点
  3. 使用大小写
  4. 财务问题
  5. 主机端点
  6. 示例
  7. 安装( 任何 MCP 客户端)
  8. 安装 (Grok)
  9. 工具参考
  10. 游戏套件( 模块)
  11. 第三人称游戏面对的字符
  12. 性能诊断
  13. 信封

@gripforgeai/ mcp (英语)

你的人工智能需要制作游戏的工具.

将提示转化为制作准备的游戏资产——以武器附着的动画人物,无缝纹理,地形,VFX,HUD等功能以及可玩游戏套件.

MCP 客户端 格普福尔 API——出自克洛德代码,Cursor,Windsurf,VS代码或任何MCP客户端.

如何使用

主机——无可安装. 指向任何具有远程能力的 MCP 客户端 https://gripforge.ai/mcp 使用您的 API 密钥( W)在此创建一个:

{
  "mcpServers": {
    "gripforge": {
      "url": "https://gripforge.ai/mcp",
      "headers": { "x-api-key": "gf_..." }
    }
  }
}

克劳德代码,用一行表示:

claude mcp add --transport http gripforge https://gripforge.ai/mcp --header "x-api-key: gf_..."

本地, 通过 npm 当代理必须将文件写入您的仓库时 :

{
  "mcpServers": {
    "gripforge": {
      "command": "npx",
      "args": ["-y", "@gripforgeai/mcp"],
      "env": { "GRIPFORGE_API_KEY": "gf_..." }
    }
  }
}

主要特点

  • 移动的字符. 描述一,得到一个被操纵的T-pose与动画集——闲置,跑跑, 攻击——准备掉入一幕.
  • 手头有武器. GripForge在任何钻机上找到手骨, 缩放道具, 关闭拳头 并返回束缚加3.js,团结和戈多的片段.
  • 无缝纹相. 可粘贴材料集,从快取出或从你自己的图像取出,升级 没有发明.
  • 地形和地图. 可玩的房间图表, 自上而下射击布局 与产卵和道, 参考文献中的灰盒重建 .
  • VFX和HUD. (英语). 为您的引擎导出动画效果和接口包 .
  • 可玩游戏套件. 集成模块化能力——运动,战斗,敌人,世界为一体 在浏览器中运行的游戏,然后将自己的资产绑定在其中.
  • 一一图书馆. 所有产生的土地在一个储物柜里 你的引擎可以拉起,你的 代理可以按外观进行搜索("恶魔May Cry like","genshin").

使用大小写

  • "把这把剑交给我的骑士,右手,然后出口武装的GLB" - 代理处理 骨头,尺子和拳头,你得到一个可以装入的文件.
  • "让我做一个黑社会老大,有三个阶段和一个竞技场" - 统计、攻击和 引擎片段重新组合起来.
  • "给这地板上一块苔藓花纹" ——无缝集,保存到图书馆.
  • "在浏览器里制造出可以玩弄的无赖" - 一个游戏工具包项目及其 绑定资产,可以从链接中播放.

财务问题

我需要安装什么? 没有。 主机端点来自任何说话的 MCP 客户端 可流取的 HTTP. npm 包存在的原因有: 让代理文件直接写入 你的仓库.

哪个引擎被支持? 团结、戈多特、不真实和三.js——资产随附着物和 片段 每个人期待.

如何计费? 每代的功劳 阅读图书馆, 动画一个现有的字符, 平面和地图包没有成本;生成一个字符或武器需要10个成本.

我的资产住在哪里? 在你的工作空间图书馆。 你可以把它们拉进你的仓库,推 和社区目录分享.

我能用我自己的概念艺术吗? 是的 — 通过一个图像, GripForge 从中构建 T-pose 工作表 而不是创造一个角色.

主机端点

需要节点——指向任何具有远程能力的MCP客户端:

https://gripforge.ai/mcp

认证 : x-api-key: gf_... 页眉(或 Authorization: Bearer) (中文(简体) ). 资产通过 作为 URL( URL) (单位:千美元)character_url, (中文(简体) ), prop_url)——Tripo/Messy下载链接工作 直接说.

// Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "gripforge": {
      "url": "https://gripforge.ai/mcp",
      "headers": { "x-api-key": "gf_..." }
    }
  }
}

示例

"把这把剑交给我的骑士,右手,然后出口武装的GLB"

经纪人打电话来 gripforge_attach 使用两个资产 URL(或本地路径) npm 包; GripForge 找到手骨,将道具缩放到 角色的手,关闭拳头 围住握手,并返回绑住JSON, 3.js /Unity / Godot spipets,以及可选带武器的GLB.

伪造一个人物 从图片 (不是从文本提示),通过 concept_item (a) 图书馆 lib_… T-pose/cept),或用 npm 包 a 当地 path 编号 : file_url这是Messy图像对3D。 没有这些田地 工具仅是文本到3D.

安装( 任何 MCP 客户端)

将服务器添加到客户端的 MCP 配置( U).mcp.json, (中文(简体) ), mcp.json,设置——形状随处可见:

{
  "mcpServers": {
    "gripforge": {
      "command": "npx",
      "args": ["-y", "@gripforgeai/mcp"],
      "env": { "GRIPFORGE_API_KEY": "gf_..." }
    }
  }
}

获取 API 密钥 https://gripforge.ai/login (英语) ——免费:15个工作室附加+ 3 API/MCP试验附后/月29欧元(100个贷项,从未到期)的信贷包.

安装 (Grok)

grok mcp add gripforge --env GRIPFORGE_API_KEY=gf_... -- npx -y @gripforgeai/mcp

或进入 ~/.grok/config.toml数字 :

[mcp_servers.gripforge]
command = "npx"
args = ["-y", "@gripforgeai/mcp"]
enabled = true
startup_timeout_sec = 45

[mcp_servers.gripforge.env]
GRIPFORGE_API_KEY = "gf_..."

也与 Cursor, Windsurf 和任何与 MCP 兼容的客户端合作—— 相同 command 编号 : args 编号 : env 3个.

工具参考

托管的 HTTP MCP (https://gripforge.ai/mcp)总是时事. 此 npm 软件包 将文件写入 repo ()out_dir,包括: gripforge_hud, (中文(简体) ), gripforge_hud_bar 财务报告和审定财务报表 gripforge_cape。仅主机: gripforge_make_seamless。 。 。 . 完整列表 : https://gripforge.ai/mcp-docs (中文(简体) )

  • gripforge_style_kit ——解决"恶魔May Cry like"/"genshin"到更衣者身份 已经用这个表情标记了. 在生成前先调用它 . 复用所证.
  • gripforge_generate_character ——新T-pose+自动架入图书馆(10分). kind=enemy 或者是"敌人"这个词 如果样式 kit 已经跳过此选项 返回一个字符.
  • gripforge_boss ——可玩性老板套件(统计,相位,攻击,竞技场,引擎片段). 积分为0. 重新使用更衣器的敌人. generate=true 造出一款新的敌手(10分). 礛 gripforge_animate 带有返回的原型.
  • gripforge_concept_correct ——概念图像 ——严格T-pose平面(1分).
  • gripforge_attach —— 字符+道具(路径或库标识)在,骨-局部结合+ 三.js / Unity / 古多特的片断。 样式:melee,枪,盾,杖(scythe/polearm). attach_id 重新使用武装束缚作为字符; prop_id_2 编号 : prop_path_2 附加第二个 (非手头) 与 export_glb: true (+ 数) out_dir还写着 attached.glb页:1 用拳头和道具连接的字符,纹理保存—— 用它来做手套钻机 其闭合的拳头不能用JSON绑住.
  • gripforge_loadout ——一个调用中的多武器字符(集+表+片段). 1 信用/道具.
  • gripforge_generate_weapon ——梅希武器GLB入库(kind=武器,多计数,样式=melee-|gun). 10个学分. 不生成 字符 .
  • gripforge_hud - 幸存者HUD包hud.json + PNGs + 数字 .tscn + 片断). 写作 out_dir (默认) ./gripforge-hud. 1 功劳.
  • gripforge_hud_bar ——原标本健康栏框+填充PNG. 写作 out_dir. 2 学分.
  • gripforge_cape 披风骨网+被剥皮 attached_cape.glb +高多特/三分片段. 写作 out_dir (默认) ./gripforge-cape. 1 功劳.
  • gripforge_formats ——支持格式和选项.
  • gripforge_library_list 编号 : get 编号 : push 编号 : pull 编号 : tag -图书馆柜子. kind=animation|audio 无效. pull 写网格 和 VFX 侧车 (单位:千美元)tex0..png/json(中文(简体) ) 输入打开的还原( e)out_dir默认值 ./gripforge-library) (中文(简体) ). 附加后保存绑定不是第二次信用.
  • gripforge_audio_kit ——更衣器 SFX + 音乐用于游戏外观. 免费.
  • gripforge_animate 将剪接包装入Mixamo图书馆的字符串(手提式剑/手提式剑/手提式剑/手提式刀/手提式刀/手提式刀/手提式刀)。 积分为0.
  • gripforge_retarget - 从A到B.
  • gripforge_rest_pose 以武器储存在有武装的捆绑上.
  • gripforge_render ——服务器 PNG 预览,使代理可以不用浏览器即可看到.
  • gripforge_scene_kit ——更衣道具+游戏外观建议布局.
  • gripforge_light_kit 编号 : gripforge_font 编号 : gripforge_navmesh ——灯光+fog,webfont+ranks,可行走的AABB. 积分为0.
  • gripforge_input_kit ——FPS输入图(WASD+箭头). 写入输入.json,自动加载GfInput. 可选 third_person: true 添加可移植字符化 JavaScript 和 a 三.js 集成示例;现有输入图不变. 积分为0.
  • gripforge_viewmodel_kit ——CS型FPS武器+相机3D/手持枪. 写入取景模式. json + gf 取景模式. gd. 积分为0.
  • gripforge_loading_page ——覆盖html/css/js+戈多特/团结/不真实. 过 character_id 16分9分仍为1分.
  • gripforge_level 可玩的房间图 从一个快。 积分为0.
  • gripforge_map_plan ——自上而下FPS/炸弹地图(泉水站站点A/B站点,车道站点,站墙站). 预览 : https://gripforge.ai/地图计划?prompt=dust2. 0 学分.
  • gripforge_map_wires ——下行电跨(2个锚+sag),不是电缆网. 和地图对等 积分为0.
  • gripforge_map_look 相机+更衣标识(shot21a A-site)。 只有LINK,从来没有Messy图像到3d。 积分为0.
  • gripforge_map_reconstruct - 收集-图 - 灰盒- 区域-相机匹配- 服装。 Dust II Valve IP:仅灰盒基准,无BSP. 相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 积分为0.
  • gripforge_hitbox - 体胶囊+ weapons[] 从捆绑或卸下.
  • gripforge_texture_prep - 当地路径或 texture_id + 无缝混合 + 忠诚 螺旋桨升级(1×/2×/4×,最大为1024或2048). 将 PNG 写入 out_dir 财务报告和审定财务报表 返回库反照率 URL。 不是发电机 无有功德.
  • gripforge_vfx_generate ——使用 preset 设置为 slash-trail, (中文(简体) ), slash-steel, (中文(简体) ), slash-fire, (中文(简体) ), slash-ice 或者说 slash-nature 仅用于一个没有AI的即时播放配方;否则文本/图像为可编辑动画的VFX规格(admin key). 接受 prompt, (中文(简体) ), visual_style,或者一个基础64 image_data 或拥有的图书馆 image_id。 。 。 .
  • gripforge_vfx 编号 : gripforge_vfx_preview ——保存/导出并取出VFX样本(admin密钥). 产生的传出 emitters 财务报告和审定财务报表 generation 与效果参数一起保存生成的结果.
  • gripforge_shaders - 列出授权的阴影目录({ id, name, engines }) (中文(简体) ). 搜索 q=slash_reveal。 。 。 .
  • gripforge_shader_pull —— 说 id + 键 engine (单位:千美元)godot|unity|three页:1 out_dir → 将消息源写入repo并返回任务片段. v1 牵引是免费的。 。 。 .
  • gripforge_performance ——分析所测量的游戏FPS,帧计时,CPU/交付 提交、可选 GPU 时间和网络间隔。 明确获取 共享工作空间抓取或直接提供报告。 积分为0.

游戏套件( 模块)

可编译的游戏游戏游戏套件( E)vehicle.driveable, (中文(简体) ), mission.objectives, (中文(简体) ), npc.wanted. ) (中文(简体) ) 安装到 Game Kit 工程中(gkp_…) 具有依赖性解析度,一个锁定文件 和浏览器播放 URL,然后交付到 Godot, Unity 或 Unreal 工程中. 所有0个贷项 除了第一次向发动机交付一个包的主要版本(每个工作空间1分). 全部参数 : https://gripforge.ai/mcp-docs (中文(简体) )

  • gripforge_gamekit_search —— 说 从这里开始:按文本、能力、标记或目标搜索目录 project_id 每一个命中都带有它的安装状态.
  • gripforge_gamekit_get ——可显示,README,配置计划+默认,一个工具包的版本(with_usage 列出使用它的项目.
  • gripforge_gamekit_install · 在项目中添加一个工具包;显示的依赖性自动解决(dry_run 以备预览).
  • gripforge_gamekit_remove - 卸下装箱(force 过去 kit_in_use, (中文(简体) ), prune 孤儿的附属关系).
  • gripforge_gamekit_configure 合并配置值或切换 enabled 并且没有完全取消.
  • gripforge_gamekit_dependencies 项目的依赖图,或目录包的表树.
  • gripforge_gamekit_update - 更新计划(干线运行)或 apply=true 以写入锁文件并运行迁移;省略 id 所有药包.
  • gripforge_gamekit_deliver ——计划(dry_run)然后为 godot 编号 : unity 编号 : unreal (单位:千美元)web 是本地的; 写入 bundle.files 如下 plan.actions。 。 。 .
  • gripforge_gamekit_deliver_local (仅此 npm 客户端)——同一快递直入 project_dir: 散开 gripforge/**,读取锁,执行动作时有备份 gripforge/.backup/<plan id>/, (中文(简体) ), verify=true 运行 Godot 无头 GODOT_BIN 已经设定.
  • gripforge_gamekit_rollback_local (仅此 npm 客户端) —— 恢复上次发送的备份并放回前一个锁.
  • gripforge_game_capabilities ——项目提供的内容,目标缺失的内容,以及哪些包能填补每个缺口.
  • gripforge_game_project —— 说 action=list|create|get|bind|data|delete 项目(约束档) lib_…数据收集, confirm=true 页:1.
  • gripforge_game_play_url ——浏览器播放项目当前修订版的URL({ url, absolute }) (中文(简体) ).

第三人称游戏面对的字符

打电话 gripforge_input_kit 与 { "prompt": "third person", "third_person": true }。 。 。 . 保存返回的内容 third_person.source_js 作为 character-facing.js;出口:

// Keep this object for the lifetime of one character.
const facingState = { velocity: 0, targetYaw: currentYaw };
updateCharacterFacing(currentYaw, {
  moveX, moveZ, lookYaw, aiming, firing, building
}, dtSeconds, facingState)

通过世界空间运动 -Z前进,以弧度计的角度和时间 在几秒钟。 行动自由使角色转向旅行方向; 站着继续完成最后的转弯 并保留这个方向。 瞄准、射击 或者建筑转向 lookYaw。转接最短的弧 受限角速度和加速度,保留连续模拟方向. 在长时间暂停后,被延后的时间被封为0.1秒. 可选状态添加 平滑加速度和制动; 旧的 三参数调用仍然可用 a 速度盖. 在远程传送或字符替换后重置状态.

回来的 usage_three 旋转外形组,保留导入的 模型的四角并保持相机控制独立. 这帮手用品 仅取向。 保持你现有的运动,物理,相机和 网络系统. 选择 third_person,或设置为 false返回 现有输入工具箱,不增加部分。 该选项可用于 主机MCP和此源检出; 它不在已公布的 npm 中 0.1.5。 。 。 .

性能诊断

gripforge_performance 包含在本源检出和主机MCP中. 已经出版的 npm 0.1.5 软件包不包括。 使用主机端点 ,或用 pnpm --filter @gripforgeai/mcp build 财务报告和审定财务报表 配置要运行的 MCP 客户端 node 绝对路径 packages/mcp-client/dist/server.js使用网站不会更新 已安装 npm 软件包.

从 API 密钥的游戏中获取最新共享的抓取 工作空间 :

{ "kit_id": "lib_your_kit_id" }

奥米 kit_id 使用该工作空间的最新捕获。 如果无 工具要求捕获或报告;它不制造测量. 或者,提供复制诊断JSON:

{
  "report": {
    "game": "Eclat Royale",
    "viewport": { "width": 1920, "height": 1080 },
    "samples": [
      { "fps": 32, "frameMs": 31.25, "p95Ms": 48, "cpuMs": 12, "submitMs": 7, "networkMs": 65 },
      { "fps": 34, "frameMs": 29.41, "p95Ms": 43, "cpuMs": 11, "submitMs": 6, "networkMs": 70 },
      { "fps": 31, "frameMs": 32.26, "p95Ms": 50, "cpuMs": 13, "submitMs": 8, "networkMs": 62 }
    ]
  }
}

这些实例值说明了格式。 受影响者的供应计量 游戏会话。 报告接受1-120个样本,每个样本都需要 fps 或者说 frameMs可选领域 pixelRatio, (中文(简体) ), quality, (中文(简体) ), level, (中文(简体) ), gpuMs, (中文(简体) ), drawCalls, (中文(简体) ), triangles 财务报告和审定财务报表 snapshotAgeMs,以及上面的计时字段. 工具在将报告发送到 格里普福尔格。 明确报告使用分析模式,不保存为抓取.

将衡量结果与建议分开。 提交格式为 CPU/司机时间已包含在内 cpuMs· ; gpuMs 只有在 实际测量。 此工具不控制浏览器, 更改游戏设置 , 发布代码或自动修正游戏.

信封

版本与发布记录

@gripforgeai/mcp 共发布 144 个版本,首次发布于 2026/08/05;过去 12 个月发布了 144 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.167latest2026/11/143 天前
0.1.1662026/11/0511 天前
0.1.1652026/11/0511 天前
0.1.1642026/11/0214 天前
0.1.1632026/11/0215 天前
0.1.1622026/11/0215 天前

关于 @gripforgeai/mcp 的常见问题

@gripforgeai/mcp 是什么?

你的人工智能需要制作游戏的工具 将提示转换为制作准备的游戏资产——带有武器附加的动画角色,无缝纹理,地形,VFX,HUD等,并为GripForge玩家,Unity,Godot和Unrea共同创建游戏

如何安装 @gripforgeai/mcp?

在项目目录运行 npm install @gripforgeai/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gripforge-mcp,可以用 npx gripforge-mcp 直接运行。

@gripforgeai/mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gripforgeai__mcp 是否存在。

@gripforgeai/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gripforgeai/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.3.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gripforgeai/mcp 可以商用吗?

@gripforgeai/mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gripforgeai/mcp 的下载量有多少?

根据 npm 官方下载统计,@gripforgeai/mcp 在 2026/10/17 – 2026/11/15 这 30 天内被下载 18,510 次,日均约 617 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gripforgeai/mcp 还在维护吗?

最新版本 0.1.167 发布于 2026/11/14(3 天前);至今共发布 144 个版本,其中过去 12 个月发布了 144 个;首次发布于 2026/08/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。