Ainpc Cli

io.github.jyswee由 GitHub 账号 jyswee 发布v1.5.4更新于 Nov 2, 2026

AI NPCs with persistent memory for game studios. NPC CRUD, dialogue, voice. Stdio or remote SSE.

发布方自己的服务：Vips

已验证Streamable HTTP可网页运行开发者工具媒体与设计AI 与机器学习

概览

AI 生成的概览

Ainpc Cli 将助手接入 AINPCEngine，用于创建、对话和管理具备持久记忆、语音与人设生成的 AI 游戏 NPC。

可以做什么
  • 在某个游戏下创建、列出、查看和管理 NPC，并可根据角色、名称与特质用 AI 生成完整人设
  • 与 NPC 对话，并通过统一 API 触发对话、战斗、交易和任务等游戏事件
  • 为 NPC 提供文本转语音的配音输出
  • 在同一套工具中处理工作室账号、用量与账单
  • 在会话内注册 AINPCEngine 工作室账号并获取 API 密钥
适用场景
适合游戏工作室或编码助手希望在终端或助手会话中批量创建、填充和测试带玩家持久记忆的 AI NPC，而不必依赖网页控制台。
运行要求
可使用远程端点并携带 Authorization Bearer 头，或通过 npx 或全局安装运行本地 npm 包。需要 AINPCEngine API 密钥，放在 AINPC_API_KEY 或 Authorization 头中，可选 AINPC_GAME_ID 将 NPC 工具限定到某个游戏。无密钥时服务器进入引导模式。
安装前请注意
注册需要提供真人邮箱和密码，返回的 API 密钥只显示一次；随后需在厂商网站添加银行卡才能开始 7 天试用，套餐自每月 29 美元起，会产生实际费用。工具可创建和修改 NPC 与游戏数据，且该服务是接收游戏内容的第三方付费平台。请勿把 API 密钥提交到版本库。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Ainpc Cli，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.jyswee%2Fainpc-cli/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "ainpc-cli": {
      "type": "http",
      "url": "https://mcp.ainpcengine.com/mcp"
    }
  }
}

README

[AINPCEngine — AI-powered NPCs with persistent memory]

ainpc — AINPCEngine CLI & MCP Server

Create, talk to, and manage AI-powered NPCs from the command line. Built for coding agents.
NPCs that remember players across sessions, react to game events, and stay in character — powered by AINPCEngine.

Website · Docs · Live Demo · Pricing

[smithery badge]

Meet the NPCs

Every one of these is a live AI NPC on the public demo — persistent memory, daily schedules, moods, and secrets. Click through and talk to them.

[Grok the Blacksmith]
Grok the Blacksmith
merchant · Village Guard
"Aye, what d'ye need? I've blades sharp enough to split a hair."		[Elara Nightbloom]
Elara Nightbloom
herbalist · Healers Circle
"Every leaf tells a story, if you know how to listen."		[Captain Voss]
Captain Voss
guard · Town Watch
"State your business or move along. I haven't got all day."		[Pip Tanglefoot]
Pip Tanglefoot
innkeeper · Merchants Guild
"Welcome, welcome! Ale's cold, stew's hot, and the beds only have a few bugs!"
[Sister Maren]
Sister Maren
priest · Temple of the Dawnlight
"The light does not judge, child. It only reveals what is already there."		[Dax Ironjaw]
Dax Ironjaw
merchant
"A fair deal? Friend, every deal I make is fair — for me."		[Old Thorn]
Old Thorn
farmer
"Rain's coming. Or trouble. Same thing, usually."		[Lyra Ashford]
Lyra Ashford
scholar · Academy of Letters
"If the answer isn't in this book, I simply haven't found the right page yet."

See It In Action

Real terminal sessions, real dashboard — no mockups. Click any card to watch.

[CLI & Coding Agents demo]
CLI & Coding Agents
Signup to a remembering NPC — one terminal, 75 seconds		[Dashboard demo]
Dashboard
Mission control: live NPC, game and interaction KPIs		[Games demo]
Games
Each game gets its own world — create one in seconds		[NPCs demo]
NPCs
Create an NPC: role, traits, speech style, backstory		[Playground demo]
Playground
Chat live with your NPC — watch it remember the debt

Why AINPCEngine

  • Persistent memory — NPCs remember every player across sessions: names, debts, favors, grudges
  • Dynamic personalities — traits, moods, daily schedules, secrets; NPCs stay in character
  • Full game-event coverage — dialogue, combat, trade, and quest events through one API
  • AI persona generation — generate a complete NPC (backstory, traits, speech style) from a role
  • NPC voice (TTS) — give any NPC a voice via the speak endpoint
  • REST + WebSocket — request/response or realtime streaming, your choice
  • Agent-native — 49 MCP tools; coding agents can create and manage NPCs end-to-end
  • SDKs for every engine — Unity, Unreal, Godot, Rust, Node.js, plus a CLI

Pricing

Plans from $29/mo with a 7-day free trial ($0 today). See pricing →

Install

bash
npm install -g ainpc-cli

Get Your API Key

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

Creates your studio and auto-saves an npk_ API key. Then log in at https://ainpcengine.com and add a card to start the 7-day free trial ($0 today, plans from $29/mo). Or sign up at https://ainpcengine.com/auth/register and generate a key in Studio Dashboard → API Keys.

Quick Start

bash
# Login (one time)ainpc login --key YOUR_API_KEY --game my-rpg
# Create an NPCainpc create "Grok the Blacksmith" --role merchant --traits gruff,loyal
# Talk to themainpc say NPC_ID "Got any swords?"
# AI-generate a full NPC (NPC Persona)ainpc generate --role guard --name "Captain Voss"
# List all NPCsainpc list
# Check statusainpc status

Per-Project Config

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

Local config overrides global. Add .ainpc/ to your .gitignore.

Agent Integration

Add to your CLAUDE.md, .cursorrules, .clinerules, or .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 Server

49 tools for AI agents: NPC CRUD, dialogue, game events, persona generation, studio account, usage and billing.

Local (stdio):

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

Requires npm install -g ainpc-cli + ainpc login --key npk_YOUR_KEY --game my-rpg (or AINPC_API_KEY env).

Remote (SSE, zero install) — for Claude Web and other web-based agents:

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

No key yet? Connect keyless — the remote server starts in onboarding mode and an agent can self-signup via the ainpc_signup tool.

Commands

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

Environment Variables

AINPC_API_KEY=your-keyAINPC_GAME_ID=my-rpgAINPC_BASE_URL=https://ainpcengine.com   # optional

Links

License

Proprietary — see LICENSE. © 2026 Tyga.Cloud Ltd.

来源：README.md，提交 5d1cc16

工具

2

ainpc_get_started

Explains what AINPCEngine is and how to activate this MCP server (no API key on this session yet).

无需输入参数。

ainpc_signup

Create a new AINPCEngine studio account. Requires the human's email and a password (min 8 chars): they log in at ainpcengine.com and add a card to start the 7-day free trial ($0 today). Returns an npk_ API key (shown once) and unlocks all AINPCEngine tools in this session immediately. Ask the human for their email before calling.

输入参数name必填planemail必填password必填

版本历史

2
  1. v1.5.4最新Sep 23, 2026
  2. v1.5.3Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。

其他 Vipsallowed 集成

Vips

com.vipsallowed官方发布者

VIPsAllowed 的 MCP 服务器让助手运营创作者业务：发布内容、管理订阅者、发送付费私信、查看收益与提现。

SSE可网页运行
金融2 个工具Oct 24, 2026

Computegpu

由 GitHub 账号 jyswee 发布

让助手租用云端 GPU：查看实时目录、部署、停止、恢复和销毁实例，按秒计费。

Streamable HTTP可网页运行
云端与基础设施2 个工具Oct 28, 2026

Weselltours

由 GitHub 账号 jyswee 发布

面向 WeSellTours 旅游平台的本地 MCP 服务器，让助手管理酒店、旅游与预订，跟踪缺陷和功能，并咨询旅游 AI。

STDIO仅桌面
位置与生活尚未验证Oct 25, 2026

Taufunctions

由 GitHub 账号 jyswee 发布

TauFunctions 让助手在 TauFunctions 平台上创建、部署、调用和监控无服务器函数，可通过 npm 本地运行或远程端点连接。

Streamable HTTP可网页运行
云端与基础设施2 个工具Oct 24, 2026

Sslwebsites

由 GitHub 账号 jyswee 发布

一个本地 MCP 服务器，让编码助手通过 SSLWebsites 服务签发、续期、吊销、下载和监控 SSL/TLS 证书。

STDIO仅桌面
云端与基础设施尚未验证Oct 24, 2026