Idle

You can run an idle dungeon crawler MCP server entirely on the client, so you don’t need a backend. This guide shows practical steps to install, configure, and use the idle dungeon server with a client, including how to initialize your game, manage your character, explore dungeons, and handle gear and events.

How to use

You connect to an MCP client and start by initializing a new game with a password and creating your character. Then you can view your status, list available dungeons, start a beginner dungeon, and check progress. Use the inventory to equip gear and manage your loadout. The system runs auto-battles in the dungeon, with outcomes influenced by your stats and luck.

How to install

Prerequisites you need installed on your system are Node.js and npm. Ensure you have a compatible runtime before proceeding.

npm install
npm run build

Additional setup and notes

You can configure the client to run the MCP idle game server locally. The server runs as a stdio process and is started with a Node command pointing to the built entry file.

{
  "mcpServers": {
    "idle-game": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-idle-game/dist/index.js"]
    }
  }
}

Security and saves

Your progress is encrypted and stored locally. Save files are AES-256-GCM encrypted and protected by a password-derived key (PBKDF2, 100,000 iterations). The password is not stored anywhere.

Usage tips

Keep your password safe, as losing it means you cannot decrypt your save data. The game uses auto-battle within dungeons, so gear and stats directly affect your performance in exploration and events.

Available tools

auto-battle

Automatic turn-based combat within dungeons that resolves battles using your current stats and luck.

dungeon_events

Random events on each dungeon floor including treasure, traps, and ambushes that affect progress.

loot_drop

Drop system where gear rarity and luck influence item drops from enemies and bosses.

encrypted_saves

AES-256-GCM encrypted local saves with password-based protection to prevent unauthorized access.

equipment_system

Four equipment slots (weapon, shield, armor, accessory) and four stats (attack, defense, speed, luck) that affect battle outcomes and dungeon progress.