ainpc-cli

ainpc — AINPCEngine 命令行工具和 MCP 服务

通过命令行创建 AI 驱动的 NPC、与其对话并进行管理。专为编码 Agent 打造。
NPC 能记住玩家在不同会话中的信息、响应游戏事件并始终保持角色设定 — 由 AINPCEngine 驱动。

网站 · 文档 · 在线演示 · 价格

---

认识这些 NPC

他们都是公开演示中的实时 AI NPC——拥有持久记忆、每日行程、情绪和秘密。点击他们的名字，与他们交谈。

铁匠格罗克 商人 · 村庄卫队 “哎，你需要什么？我的刀刃锋利得足以劈开一根头发。”	伊莱拉·夜绽 草药师 · 治疗者协会 “每片叶子都会讲述一个故事，只要你知道如何倾听。”	沃斯队长 卫兵 · 镇守卫 “说清楚你的来意，否则就走开。我可没那么多时间。”	皮普·绊脚 旅店老板 · 商人公会 “欢迎，欢迎！麦酒冰凉，炖菜滚烫，床上只有几只虫子！”
玛伦修女 祭司 · 晨光神殿 “光明不会评判你，孩子。它只会照亮本就存在的东西。”	达克斯·铁颚 商人 “公平交易？朋友，我做的每笔交易都公平——对我来说。”	老荆棘 农夫 “要下雨了。或者要出麻烦了。通常都一样。”	莱拉·阿什福德 学者 · 文学院 “如果这本书里没有答案，那只是我还没找到正确的那一页。”

## 实际演示

真实的终端会话，真实的控制面板——没有模拟效果。点击任意卡片即可观看。

CLI 与编码 Agent 从注册到拥有会记忆的 NPC——一个终端，75 秒

控制面板 任务控制中心：NPC、游戏和互动 KPI 实时呈现

游戏 每款游戏都有自己的世界——几秒钟内即可创建

NPC 创建 NPC：角色、特质、说话风格、背景故事

试玩场 与 NPC 实时聊天——看它记住那笔债

为什么选择 AINPCEngine

• 持久记忆 — NPC 会跨会话记住每位玩家：姓名、债务、人情和积怨
• 动态个性 — 特质、情绪、日常安排、秘密；NPC 始终保持角色设定
• 全面覆盖游戏事件 — 通过一个 API 处理对话、战斗、交易和任务事件
• AI 人设生成 — 根据角色生成完整的 NPC（背景故事、特质、说话风格）
• NPC 语音（TTS） — 通过 speak 端点为任意 NPC 配上语音
• REST + WebSocket — 请求/响应或实时流式传输，由你选择
• 原生支持 Agent — 提供 49 个 MCP 工具；编码 Agent 可端到端创建和管理 NPC
• 适用于各种引擎的 SDK — Unity、Unreal、Godot、Rust、Node.js，以及 CLI

定价

套餐起价 $29/月，提供 7 天免费试用（今天支付 $0）。查看定价 →

安装

npm install -g ainpc-cli

获取 API 密钥

ainpc signup "My Studio" --email [email protected] --password ********

此操作会创建你的工作室并自动保存一个 npk_ API 密钥。然后登录 https://ainpcengine.com 并添加银行卡，即可开始 7 天免费试用（今天支付 $0，套餐起价 $29/月）。或者前往 https://ainpcengine.com/auth/register 注册，并在 Studio Dashboard → API Keys 中生成密钥。

快速入门

# Login (one time)
ainpc login --key YOUR_API_KEY --game my-rpg

# Create an NPC
ainpc create "Grok the Blacksmith" --role merchant --traits gruff,loyal

# Talk to them
ainpc say NPC_ID "Got any swords?"

# AI-generate a full NPC (NPC Persona)
ainpc generate --role guard --name "Captain Voss"

# List all NPCs
ainpc list

# Check status
ainpc status

项目专属配置

ainpc login --local --key YOUR_KEY --game my-rpg   # saves to .ainpc/config.json
ainpc login --key YOUR_KEY --game my-rpg           # saves to ~/.ainpc/config.json
ainpc config                                       # show active config

本地配置会覆盖全局配置。将 .ainpc/ 添加到 .gitignore。

Agent 集成

将以下内容添加到你的 CLAUDE.md、.cursorrules、.clinerules 或 .windsurfrules：

Use the ainpc CLI for NPC management.
Config auto-loaded from .ainpc/config.json or AINPC_API_KEY env.
Run ainpc --help for full reference.

MCP 服务

为 AI Agent 提供 49 个工具：NPC CRUD、对话、游戏事件、人设生成、工作室账户、用量和账单。

本地（stdio）：

{ "mcpServers": { "ainpcengine": { "type": "stdio", "command": "ainpc", "args": ["mcp-serve"] } } }

需要执行 npm install -g ainpc-cli 和 ainpc login --key npk_YOUR_KEY --game my-rpg（或设置 AINPC_API_KEY 环境变量）。

远程（SSE，无需安装） — 适用于 Claude Web 和其他基于 Web 的 Agent：

{ "mcpServers": { "ainpcengine": { "type": "sse", "url": "https://mcp.ainpcengine.com/sse",
  "headers": { "Authorization": "Bearer npk_YOUR_API_KEY" } } } }

还没有密钥？无需密钥即可连接——远程服务会以引导模式启动，Agent 可通过 ainpc_signup 工具自行注册。

命令

ainpc create "Name" --role R          Create NPC
ainpc list                            List all NPCs
ainpc show NPC_ID                     Show detail
ainpc say NPC_ID "message"            Talk to NPC
ainpc generate --role guard           AI-generate NPC
ainpc speak NPC_ID "text"             NPC voice (TTS)
ainpc status                          Quick overview
ainpc --help                          Full reference

环境变量

AINPC_API_KEY=your-key
AINPC_GAME_ID=my-rpg
AINPC_BASE_URL=https://ainpcengine.com   # optional

链接

• 平台：https://ainpcengine.com
• 文档：https://ainpcengine.com/docs
• 演示：https://ainpcengine.com/demo

许可证

专有软件——请参阅 LICENSE。© 2026 Tyga.Cloud Ltd.