Permettez aux agents IA de créer, gérer et interagir avec des PNJ dotés d'une mémoire persistante, de personnalités dynamiques et de capacités vocales.
Aussi connu sous jyswee/ainpc-cli
- Étoiles
- 1
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 1.5.4
- Dernier commit
- 14 nov. 2026
- Licence
- —
Qu'est-ce que AINPCEngine MCP ?
AINPCEngine est un serveur MCP. Permettez aux agents IA de créer, gérer et interagir avec des PNJ dotés d'une mémoire persistante, de personnalités dynamiques et de capacités vocales.
Résumé généré à partir du README du projet
À propos du MCP server AINPCEngine
ainpc-cli permet de créer et de gérer des personnages de jeu intelligents directement depuis un agent IA. Ce MCP server fournit aux agents de codage 49 outils spécialisés pour gérer le cycle de vie des PNJ, incluant la création, le dialogue et la génération de personas. Il est conçu pour les développeurs qui créent des jeux ou des simulations et qui ont besoin de personnages dotés d'une mémoire persistante, d'humeurs dynamiques et d'emplois du temps quotidiens réagissant aux actions des joueurs.
Les utilisateurs peuvent configurer le serveur localement en utilisant le transport stdio en installant le CLI via npm et en se connectant avec une clé API. Pour les agents basés sur le web, une connexion SSE distante est disponible et nécessite un en-tête Authorization avec votre clé API. Le système prend en charge à la fois le modèle requête-réponse et le streaming en temps réel via les protocoles REST et WebSocket. Au-delà du simple texte, le serveur inclut un endpoint speak pour offrir des capacités vocales aux personnages via du text-to-speech.
Ce que vous pouvez faire avec
- 1Générer des personas de PNJ completsDemandez à un agent IA de construire un personnage entièrement développé, incluant son histoire et son style de langage, à partir d'un simple rôle.
- 2Gérer la mémoire et les dialogues des personnagesUtilisez un agent pour interagir avec les PNJ afin de tester la manière dont ils se souviennent des dettes, des faveurs ou des rancunes des joueurs d'une session à l'autre.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer AINPCEngine MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller AINPCEngine MCP dans Claude Code
$ claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cliInstaller AINPCEngine MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Installer AINPCEngine MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"ainpc-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Installer AINPCEngine MCP dans 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>"}}'Installer AINPCEngine MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Installer AINPCEngine MCP dans Codex
$ codex mcp add ainpc-cli --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' -- npx -y ainpc-cliInstaller AINPCEngine MCP dans 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>"
Installer AINPCEngine MCP dans Gemini CLI
$ gemini mcp add -s user -e 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli npx -- -y ainpc-cliInstaller AINPCEngine MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Configuration
AINPC_API_KEYRequisSecretAINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.
AINPC_BASE_URLAINPC_GAME_IDGame slug to scope NPC tools to.
| Nom | Description | Type |
|---|---|---|
| AINPC_API_KEY | AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial. | RequisSecret |
| AINPC_BASE_URL | — | |
| AINPC_GAME_ID | Game slug to scope NPC tools to. |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblejyswee/ainpc-cli is public and reachablegithub.com/jyswee/ainpc-cli ↗Réussi
- Le nom du package correspond au dépôt sourceainpc-cli names jyswee/ainpc-cli as sourcenpmjs.com/package/ainpc-cli ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)No licenseFaille
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-09-24github.com/jyswee/ainpc-cli ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from ainpc-cliRéussi
- Aucun avis critique dans le package ou ses dépendances1 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPinitialize answered with protocol 2025-06-18 in 115 msRéussi
README
Voir sur 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.
Questions sur AINPCEngine MCP
Comment ajouter AINPCEngine MCP à Claude Code ?
Exécutez claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cli dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter AINPCEngine MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Que peut faire l'agent IA avec ce serveur ?
Le serveur fournit 49 outils permettant aux agents IA d'effectuer des opérations CRUD sur les PNJ, de gérer les dialogues, les événements de jeu, la génération de personas et la gestion des comptes studio.
Les PNJ ont-ils une mémoire ?
Oui, les PNJ disposent d'une mémoire persistante, ce qui leur permet de se souvenir des joueurs, des noms, des dettes, des faveurs et des rancunes d'une session à l'autre.
Comment installer le CLI ?
Vous pouvez installer le CLI globalement en utilisant la commande npm : npm install -g ainpc-cli.
Puis-je utiliser cela avec des agents basés sur le web comme Claude Web ?
Oui, vous pouvez utiliser la connexion SSE distante pour Claude Web et d'autres agents web sans nécessiter d'installation locale.