Biarkan AI agent membuat, mengelola, dan berinteraksi dengan NPC yang memiliki memori persisten, kepribadian dinamis, dan kemampuan suara.
Juga dikenal sebagai jyswee/ainpc-cli
- Stars
- 1
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.5.4
- Commit terakhir
- 24 Sep 2026
- Lisensi
- —
Apa itu AINPCEngine MCP?
AINPCEngine adalah MCP server. Biarkan AI agent membuat, mengelola, dan berinteraksi dengan NPC yang memiliki memori persisten, kepribadian dinamis, dan kemampuan suara.
Ringkasan dibuat dari README proyek
Tentang AINPCEngine MCP server
ainpc-cli memungkinkan Anda membuat dan mengelola karakter game yang cerdas langsung dari dalam AI agent. MCP server ini menyediakan 49 tools khusus bagi coding agent untuk menangani tugas lifecycle NPC, termasuk pembuatan, dialog, dan pembuatan persona. Server ini dirancang untuk developer yang sedang membangun game atau simulasi yang membutuhkan karakter dengan memori persisten, mood dinamis, dan jadwal harian yang bereaksi terhadap tindakan pemain.
User dapat menyiapkan server secara lokal menggunakan transport stdio dengan menginstall CLI via npm dan login menggunakan API key. Untuk agent berbasis web, tersedia koneksi remote SSE yang memerlukan Authorization header dengan API key Anda. Sistem ini mendukung request-response maupun real-time streaming melalui protokol REST dan WebSocket. Selain teks sederhana, server ini menyertakan endpoint speak untuk memberikan kemampuan suara pada karakter melalui text-to-speech.
Apa yang bisa Anda lakukan dengannya
- 1Generate persona NPC yang lengkapMinta AI agent untuk membangun karakter yang mendalam, termasuk backstory dan gaya bicara berdasarkan peran yang sederhana.
- 2Kelola memori dan dialog karakterGunakan agent untuk berinteraksi dengan NPC guna menguji bagaimana mereka mengingat hutang, bantuan, atau dendam pemain di berbagai sesi yang berbeda.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal AINPCEngine MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal AINPCEngine MCP di Claude Code
$ claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cliInstal AINPCEngine MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Instal AINPCEngine MCP di VS Code
.vscode/mcp.json
{
"servers": {
"ainpc-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Instal AINPCEngine MCP di VS Code CLI
$ code --add-mcp '{"name":"ainpc-cli","type":"stdio","command":"npx","args":["-y","ainpc-cli"],"env":{"AINPC_API_KEY":"<YOUR_AINPC_API_KEY>"}}'Instal AINPCEngine MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Instal AINPCEngine MCP di Codex
$ codex mcp add ainpc-cli --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' -- npx -y ainpc-cliInstal AINPCEngine MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.ainpc-cli] command = "npx" args = ["-y", "ainpc-cli"] [mcp_servers.ainpc-cli.env] AINPC_API_KEY = "<YOUR_AINPC_API_KEY>"
Instal AINPCEngine MCP di Gemini CLI
$ gemini mcp add -s user -e 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli npx -- -y ainpc-cliInstal AINPCEngine MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Konfigurasi
AINPC_API_KEYWajibRahasiaAINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.
AINPC_BASE_URLAINPC_GAME_IDGame slug to scope NPC tools to.
| Nama | Deskripsi | Tipe |
|---|---|---|
| AINPC_API_KEY | AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial. | WajibRahasia |
| AINPC_BASE_URL | — | |
| AINPC_GAME_ID | Game slug to scope NPC tools to. |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaujyswee/ainpc-cli is public and reachablegithub.com/jyswee/ainpc-cli ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaainpc-cli names jyswee/ainpc-cli as sourcenpmjs.com/package/ainpc-cli ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-09-24github.com/jyswee/ainpc-cli ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from ainpc-cliLolos
- Tidak ada advisory kritis pada paket atau dependensinya1 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPinitialize answered with protocol 2025-06-18 in 115 msLolos
README
Lihat di GitHubMeet 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.
See It In Action
Real terminal sessions, real dashboard — no mockups. Click any card to watch.
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
npm install -g ainpc-cli
Get Your API Key
ainpc signup "My Studio" --email you@studio.com --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
# 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
Per-Project Config
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
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):
{ "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:
{ "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 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
Environment Variables
AINPC_API_KEY=your-key
AINPC_GAME_ID=my-rpg
AINPC_BASE_URL=https://ainpcengine.com # optional
Links
- Platform: https://ainpcengine.com
- Docs: https://ainpcengine.com/docs
- Demo: https://ainpcengine.com/demo
License
Proprietary — see LICENSE. © 2026 Tyga.Cloud Ltd.
Pertanyaan tentang AINPCEngine MCP
Bagaimana cara menambahkan AINPCEngine MCP ke Claude Code?
Jalankan claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cli di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan AINPCEngine MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apa yang bisa dilakukan AI agent dengan server ini?
Server ini menyediakan 49 tools agar AI agent dapat melakukan operasi CRUD NPC, dialog, game events, pembuatan persona, dan mengelola akun studio.
Apakah NPC memiliki memori?
Ya, NPC memiliki memori persisten yang memungkinkan mereka mengingat pemain, nama, hutang, bantuan, dan dendam di berbagai sesi yang berbeda.
Bagaimana cara menginstall CLI?
Anda dapat menginstall CLI secara global menggunakan perintah npm: npm install -g ainpc-cli.
Bisakah saya menggunakan ini dengan agent berbasis web seperti Claude Web?
Ya, Anda dapat menggunakan koneksi remote SSE untuk Claude Web dan agent berbasis web lainnya tanpa perlu melakukan instalasi lokal.