# @gripforgeai/mcp 中文文档

规范地址：https://npmcn.com/package/%40gripforgeai/mcp/

版本：0\.1\.167
npm 元数据更新时间：2026-11-14T01:39:53.446Z
中文译文更新时间：2026-11-17T00:51:10.365Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gripforgeai/mcp
原文对照：https://npmcn.com/package/%40gripforgeai/mcp/?lang=original
项目主页：https://github.com/gripforgeai/mcp#readme
源码仓库：https://github.com/gripforgeai/mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4 MB，77 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.3\.0
- 运行依赖：2 个
- 首次发布：2026-08-05T13:57:06.984Z
- 最新版本发布：2026-11-14T01:39:53.134Z
- 近 30 天下载量：18510（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：144（近 12 个月 144 个）

## 中文简介

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

## 安装

```sh
npm install @gripforgeai/mcp
```

也可以使用：`pnpm add @gripforgeai/mcp`、`yarn add @gripforgeai/mcp`、`bun add @gripforgeai/mcp`

## README

# @gripforgeai/ mcp (英语)

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

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

MCP 客户端 [格普福尔](https://gripforge.ai/) API——出自克洛德代码,Cursor,Windsurf,VS代码或任何MCP客户端.

## 如何使用

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

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

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

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

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

```jsonc
{
  "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下载链接工作 直接说.

```jsonc
// 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`,设置——形状随处可见:

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

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

## 安装 (Grok)

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

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

```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 (中文(简体) )](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](https://gripforge.ai/map-plan?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 (中文(简体) )](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`;出口:

```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 密钥的游戏中获取最新共享的抓取 工作空间 :

```json
{ "kit_id": "lib_your_kit_id" }
```

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

```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` 只有在 实际测量。 此工具不控制浏览器, 更改游戏设置 , 发布代码或自动修正游戏.

## 信封

-   `GRIPFORGE_API_KEY` (所需)——1个入分=1个成功附着
-   `GRIPFORGE_API_URL` (可选)——默认为 [https://gripforge.ai (英语)](https://gripforge.ai/)

## 常见问题

### @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 和提交记录判断。

