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