AIエージェントが、永続的なメモリ、動的なパーソナリティ、音声機能を備えたNPCを作成、管理、および対話できるようにします。
別名 jyswee/ainpc-cli
- スター
- 1
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.5.4
- 最終コミット
- 2026年9月24日
- ライセンス
- —
AINPCEngine MCPとは
AINPCEngineはMCPサーバーです。 AIエージェントが、永続的なメモリ、動的なパーソナリティ、音声機能を備えたNPCを作成、管理、および対話できるようにします。.
プロジェクトのREADMEから生成された概要
AINPCEngine MCP server について
ainpc-cliは、AIエージェント内からインテリジェントなゲームキャラクターを作成および管理することを可能にします。このMCP serverは、作成、対話、ペルソナ生成を含むNPCのライフサイクルタスクを処理するための49個の特化したツールをコーディングエージェントに提供します。プレイヤーの行動に反応する、永続的なメモリ、動的な気分、日課を持つキャラクターを必要とするゲームやシミュレーションの開発者向けに設計されています。
ユーザーは、npm経由でCLIをインストールし、APIキーでログインすることで、stdioトランスポートを使用してサーバーをローカルにセットアップできます。Webベースのエージェントについては、APIキーを含むAuthorizationヘッダーを必要とするリモートSSE接続が利用可能です。システムは、RESTおよびWebSocketプロトコルを通じて、リクエスト/レスポンスとリアルタイムストリーミングの両方をサポートしています。単純なテキストだけでなく、サーバーにはspeakエンドポイントが含まれており、テキスト読み上げを通じてキャラクターに音声機能を提供できます。
できること
- 1完全なNPCペルソナの生成単純な役割に基づいて、バックストーリーや話し方を含む、詳細に作り込まれたキャラクターをAIエージェントに構築させます。
- 2キャラクターのメモリと対話の管理エージェントにNPCと対話させ、プレイヤーの借金、恩義、または恨みを異なるセッション間でどのように記憶しているかをテストします。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
AINPCEngine MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにAINPCEngine MCPをインストール
$ claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cliCursorにAINPCEngine MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}VS CodeにAINPCEngine MCPをインストール
.vscode/mcp.json
{
"servers": {
"ainpc-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}VS Code CLIにAINPCEngine MCPをインストール
$ code --add-mcp '{"name":"ainpc-cli","type":"stdio","command":"npx","args":["-y","ainpc-cli"],"env":{"AINPC_API_KEY":"<YOUR_AINPC_API_KEY>"}}'Claude DesktopにAINPCEngine MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}CodexにAINPCEngine MCPをインストール
$ codex mcp add ainpc-cli --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' -- npx -y ainpc-cliCodex config.tomlにAINPCEngine MCPをインストール
~/.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>"
Gemini CLIにAINPCEngine MCPをインストール
$ gemini mcp add -s user -e 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli npx -- -y ainpc-cliGemini settings.jsonにAINPCEngine MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"ainpc-cli": {
"command": "npx",
"args": [
"-y",
"ainpc-cli"
],
"env": {
"AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
}
}
}
}設定
AINPC_API_KEY必須シークレットAINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.
AINPC_BASE_URLAINPC_GAME_IDGame slug to scope NPC tools to.
| 名前 | 説明 | 種類 |
|---|---|---|
| AINPC_API_KEY | AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial. | 必須シークレット |
| AINPC_BASE_URL | — | |
| AINPC_GAME_ID | Game slug to scope NPC tools to. |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能jyswee/ainpc-cli is public and reachablegithub.com/jyswee/ainpc-cli ↗合格
- パッケージがこのリポジトリをソースとして指定ainpc-cli names jyswee/ainpc-cli as sourcenpmjs.com/package/ainpc-cli ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-09-24github.com/jyswee/ainpc-cli ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from ainpc-cli合格
- パッケージおよびその依存関係に重大な勧告なし1 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 115 ms合格
README
GitHubで見る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のよくある質問
AINPCEngine MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cliを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
AINPCEngine MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
このMCP serverでAIエージェントは何ができますか?
このサーバーは、AIエージェントがNPCのCRUD操作、対話、ゲームイベント、ペルソナ生成、およびスタジオアカウントの管理を行うための49個のツールを提供します。
NPCはメモリを持っていますか?
はい、NPCは永続的なメモリを備えており、異なるセッションをまたいでプレイヤー、名前、借金、恩義、恨みなどを記憶することができます。
CLIのインストール方法を教えてください。
npmコマンドを使用して、CLIをグローバルにインストールできます:npm install -g ainpc-cli。
Claude WebのようなWebベースのエージェントでも使用できますか?
はい、ローカルへのインストールは不要で、Claude Webやその他のWebベースのエージェントでリモートSSE接続を使用できます。