AI agent'ların kalıcı hafızaya, dinamik kişiliklere ve ses yeteneklerine sahip NPC'ler oluşturmasına, yönetmesine ve onlarla etkileşime girmesine olanak tanır.
Ayrıca bilinen adı jyswee/ainpc-cli
- Yıldızlar
- 1
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.5.4
- Son commit
- 24 Eyl 2026
- Lisans
- —
AINPCEngine MCP nedir?
AINPCEngine bir MCP sunucusudur. AI agent'ların kalıcı hafızaya, dinamik kişiliklere ve ses yeteneklerine sahip NPC'ler oluşturmasına, yönetmesine ve onlarla etkileşime girmesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
AINPCEngine MCP sunucusu hakkında
ainpc-cli, akıllı oyun karakterlerini bir AI agent içerisinden oluşturmayı ve yönetmeyi sağlar. Bu MCP server, kodlama agent'larına NPC yaşam döngüsü görevlerini (oluşturma, diyalog ve persona oluşturma dahil) yönetmeleri için 49 özel araç sunar. Kalıcı hafızaya, dinamik ruh hallerine ve oyuncu eylemlerine tepki veren günlük programlara sahip karakterlere ihtiyaç duyan oyun veya simülasyon geliştiricileri için tasarlanmıştır.
Kullanıcılar, CLI'yı npm üzerinden kurup bir API key ile giriş yaparak stdio transport kullanarak server'ı yerel olarak kurabilirler. Web tabanlı agent'lar için, API key'inizi içeren bir Authorization header gerektiren uzak bir SSE bağlantısı mevcuttur. Sistem, REST ve WebSocket protokolleri aracılığıyla hem request-response hem de gerçek zamanlı streaming yöntemlerini destekler. Basit metinlerin ötesinde server, karakterlere text-to-speech aracılığıyla ses yetenekleri kazandırmak için bir speak endpoint'i içerir.
Neler yapabilirsiniz
- 1Tam kapsamlı NPC personaları oluşturunBir AI agent'tan, basit bir rol temelinde geçmiş hikayesi ve konuşma tarzı dahil olmak üzere tamamen geliştirilmiş bir karakter oluşturmasını isteyin.
- 2Karakter hafızasını ve diyaloglarını yönetinNPC'lerin oyuncu borçlarını, iyiliklerini veya düşmanlıklarını farklı oturumlar boyunca nasıl hatırladıklarını test etmek için bir agent'ın NPC'lerle etkileşime girmesini sağlayın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
AINPCEngine MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleAINPCEngine MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cliAINPCEngine MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}AINPCEngine MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"ainpc-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}AINPCEngine MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"ainpc-cli","type":"stdio","command":"npx","args":["-y","ainpc-cli"],"env":{"AINPC_API_KEY":"<YOUR_AINPC_API_KEY>"}}'AINPCEngine MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}AINPCEngine MCP'yi Codex içine yükleyin
$ codex mcp add ainpc-cli --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' -- npx -y ainpc-cliAINPCEngine MCP'yi Codex config.toml içine yükleyin
~/.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>"
AINPCEngine MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli npx -- -y ainpc-cliAINPCEngine MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Yapılandırma
AINPC_API_KEYGerekliGizliAINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.
AINPC_BASE_URLAINPC_GAME_IDGame slug to scope NPC tools to.
| Ad | Açıklama | Sunucu |
|---|---|---|
| AINPC_API_KEY | AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial. | GerekliGizli |
| AINPC_BASE_URL | — | |
| AINPC_GAME_ID | Game slug to scope NPC tools to. |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirjyswee/ainpc-cli is public and reachablegithub.com/jyswee/ainpc-cli ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorainpc-cli names jyswee/ainpc-cli as sourcenpmjs.com/package/ainpc-cli ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-09-24github.com/jyswee/ainpc-cli ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from ainpc-cliGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok1 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-06-18 in 115 msGeçti
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.
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.
AINPCEngine MCP soruları
AINPCEngine MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cli komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
AINPCEngine MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Bu server ile AI agent neler yapabilir?
Server, AI agent'ların NPC CRUD işlemleri, diyalog, oyun etkinlikleri, persona oluşturma ve stüdyo hesaplarını yönetmesi için 49 adet araç sağlar.
NPC'lerin hafızası var mı?
Evet, NPC'ler kalıcı hafızaya sahiptir; bu sayede oyuncuları, isimleri, borçları, iyilikleri ve düşmanlıkları farklı oturumlar boyunca hatırlayabilirler.
CLI nasıl kurulur?
CLI'yı npm komutunu kullanarak global olarak kurabilirsiniz: npm install -g ainpc-cli.
Bunu Claude Web gibi web tabanlı agent'lar ile kullanabilir miyim?
Evet, yerel bir kurulum yapmanıza gerek kalmadan Claude Web ve diğer web tabanlı agent'lar için uzak SSE bağlantısını kullanabilirsiniz.