Permite que los agentes de IA creen, gestionen e interactúen con NPCs que cuentan con memoria persistente, personalidades dinámicas y capacidades de voz.
También conocido como jyswee/ainpc-cli
- Stars
- 1
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.5.4
- Último commit
- 24 sept 2026
- Licencia
- —
¿Qué es AINPCEngine MCP?
AINPCEngine es un MCP server. Permite que los agentes de IA creen, gestionen e interactúen con NPCs que cuentan con memoria persistente, personalidades dinámicas y capacidades de voz.
Resumen generado a partir del README del proyecto
Acerca del MCP server de AINPCEngine
ainpc-cli permite crear y gestionar personajes de juego inteligentes directamente desde un agente de IA. Este MCP server proporciona a los agentes de codificación 49 herramientas especializadas para manejar el ciclo de vida de los NPCs, incluyendo su creación, diálogo y generación de personalidades. Está diseñado para desarrolladores que crean juegos o simulaciones y necesitan personajes con memoria persistente, estados de ánimo dinámicos y horarios diarios que reaccionen a las acciones del jugador.
Los usuarios pueden configurar el servidor localmente usando el transporte stdio instalando la CLI vía npm e iniciando sesión con una API key. Para agentes basados en web, hay disponible una conexión remota SSE que requiere un encabezado Authorization con tu API key. El sistema soporta tanto el modelo de solicitud-respuesta como el streaming en tiempo real a través de protocolos REST y WebSocket. Más allá del texto simple, el servidor incluye un endpoint speak para dotar de capacidades de voz a los personajes mediante text-to-speech.
Qué puedes hacer con él
- 1Generar personalidades completas de NPCsPide a un agente de IA que construya un personaje totalmente desarrollado, incluyendo su trasfondo y estilo de habla, basándose en un rol simple.
- 2Gestionar la memoria y el diálogo de los personajesHaz que un agente interactúe con los NPCs para probar cómo recuerdan deudas, favores o rencores de los jugadores a través de diferentes sesiones.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar AINPCEngine MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar AINPCEngine MCP en Claude Code
$ claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cliInstalar AINPCEngine MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Instalar AINPCEngine MCP en VS Code
.vscode/mcp.json
{
"servers": {
"ainpc-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Instalar AINPCEngine MCP en 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>"}}'Instalar AINPCEngine MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Instalar AINPCEngine MCP en Codex
$ codex mcp add ainpc-cli --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' -- npx -y ainpc-cliInstalar AINPCEngine MCP en 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>"
Instalar AINPCEngine MCP en Gemini CLI
$ gemini mcp add -s user -e 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli npx -- -y ainpc-cliInstalar AINPCEngine MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Configuración
AINPC_API_KEYObligatorioSecretoAINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.
AINPC_BASE_URLAINPC_GAME_IDGame slug to scope NPC tools to.
| Nombre | Descripción | Tipo |
|---|---|---|
| AINPC_API_KEY | AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial. | ObligatorioSecreto |
| AINPC_BASE_URL | — | |
| AINPC_GAME_ID | Game slug to scope NPC tools to. |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblejyswee/ainpc-cli is public and reachablegithub.com/jyswee/ainpc-cli ↗Aprobado
- El paquete indica este repositorio como su origenainpc-cli names jyswee/ainpc-cli as sourcenpmjs.com/package/ainpc-cli ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoLast commit or release 2026-09-24github.com/jyswee/ainpc-cli ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from ainpc-cliAprobado
- No hay avisos críticos en el paquete ni en sus dependencias1 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 115 msAprobado
README
Ver en 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.
Preguntas sobre AINPCEngine MCP
¿Cómo agrego AINPCEngine MCP a Claude Code?
Ejecuta claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cli en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego AINPCEngine MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué puede hacer el agente de IA con este servidor?
El servidor proporciona 49 herramientas para que los agentes de IA realicen operaciones CRUD de NPCs, diálogos, eventos de juego, generación de personas y gestión de cuentas de estudio.
¿Los NPCs tienen memoria?
Sí, los NPCs cuentan con memoria persistente, lo que les permite recordar jugadores, nombres, deudas, favores y rencores a través de diferentes sesiones.
¿Cómo instalo la CLI?
Puedes instalar la CLI de forma global usando el comando npm: npm install -g ainpc-cli.
¿Puedo usar esto con agentes basados en web como Claude Web?
Sí, puedes usar la conexión remota SSE para Claude Web y otros agentes basados en web sin necesidad de una instalación local.