Lass KI-Agenten NPCs erstellen, verwalten und mit ihnen interagieren, die über persistentes Gedächtnis, dynamische Persönlichkeiten und Sprachfunktionen verfügen.
Auch bekannt als jyswee/ainpc-cli
- Stars
- 1
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.5.4
- Letzter Commit
- 24. Sept. 2026
- Lizenz
- —
Was ist AINPCEngine MCP?
AINPCEngine ist ein MCP server. Lass KI-Agenten NPCs erstellen, verwalten und mit ihnen interagieren, die über persistentes Gedächtnis, dynamische Persönlichkeiten und Sprachfunktionen verfügen.
Zusammenfassung generiert aus dem README des Projekts
Über AINPCEngine MCP server
ainpc-cli ermöglicht es dir, intelligente Spielecharaktere direkt aus einem KI-Agenten heraus zu erstellen und zu verwalten. Dieser MCP server bietet Coding-Agenten 49 spezialisierte Tools, um den gesamten NPC-Lifecycle zu handhaben, einschließlich Erstellung, Dialogen und Persona-Generierung. Er wurde für Entwickler konzipiert, die Spiele oder Simulationen bauen und Charaktere mit persistentem Gedächtnis, dynamischen Stimmungen und Tagesabläufen benötigen, die auf Spieleraktionen reagieren.
Nutzer können den Server lokal über den stdio-Transport einrichten, indem sie das CLI via npm installieren und sich mit einem API-Key anmelden. Für webbasierte Agenten steht eine remote SSE-Verbindung zur Verfügung, die einen Authorization-Header mit deinem API-Key erfordert. Das System unterstützt sowohl Request-Response als auch Echtzeit-Streaming über REST- und WebSocket-Protokolle. Über einfachen Text hinaus bietet der Server einen speak-Endpoint, um Charakteren mittels Text-to-Speech Sprachfunktionen zu verleihen.
Was du damit machen kannst
- 1Vollständige NPC-Personas generierenFordere einen KI-Agenten auf, einen voll ausgearbeiteten Charakter inklusive Hintergrundgeschichte und Sprachstil basierend auf einer einfachen Rolle zu erstellen.
- 2Charakter-Gedächtnis und Dialoge verwaltenLass einen Agenten mit NPCs interagieren, um zu testen, wie sie sich an Spieler-Schulden, Gefallen oder Groll über verschiedene Sessions hinweg erinnern.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du AINPCEngine MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenAINPCEngine MCP in Claude Code installieren
$ claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cliAINPCEngine MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}AINPCEngine MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"ainpc-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}AINPCEngine MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"ainpc-cli","type":"stdio","command":"npx","args":["-y","ainpc-cli"],"env":{"AINPC_API_KEY":"<YOUR_AINPC_API_KEY>"}}'AINPCEngine MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}AINPCEngine MCP in Codex installieren
$ codex mcp add ainpc-cli --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' -- npx -y ainpc-cliAINPCEngine MCP in Codex config.toml installieren
~/.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 in Gemini CLI installieren
$ gemini mcp add -s user -e 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli npx -- -y ainpc-cliAINPCEngine MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}Konfiguration
AINPC_API_KEYErforderlichSecretAINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.
AINPC_BASE_URLAINPC_GAME_IDGame slug to scope NPC tools to.
| Name | Beschreibung | Typ |
|---|---|---|
| AINPC_API_KEY | AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial. | ErforderlichSecret |
| AINPC_BASE_URL | — | |
| AINPC_GAME_ID | Game slug to scope NPC tools to. |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarjyswee/ainpc-cli is public and reachablegithub.com/jyswee/ainpc-cli ↗Bestanden
- Paket nennt dieses Repository als Quelleainpc-cli names jyswee/ainpc-cli as sourcenpmjs.com/package/ainpc-cli ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)No licenseBefund
- Commit oder Release im letzten JahrLast commit or release 2026-09-24github.com/jyswee/ainpc-cli ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from ainpc-cliBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten1 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 115 msBestanden
README
Auf GitHub ansehenMeet 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 Fragen
Wie füge ich AINPCEngine MCP zu Claude Code hinzu?
Führe claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cli in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich AINPCEngine MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Was kann der KI-Agent mit diesem Server machen?
Der Server bietet 49 Tools, mit denen KI-Agenten NPC-CRUD-Operationen, Dialoge und Game Events durchführen, Personas generieren und Studio-Accounts verwalten können.
Haben die NPCs ein Gedächtnis?
Ja, die NPCs verfügen über persistentes Gedächtnis, wodurch sie sich über verschiedene Sessions hinweg an Spieler, Namen, Schulden, Gefallen und Groll erinnern können.
Wie installiere ich das CLI?
Du kannst das CLI global über den npm-Befehl installieren: npm install -g ainpc-cli.
Kann ich das mit webbasierten Agenten wie Claude Web nutzen?
Ja, du kannst die remote SSE-Verbindung für Claude Web und andere webbasierte Agenten nutzen, ohne eine lokale Installation zu benötigen.