DevRPG-MCP

An MCP server that turns your development workflow into an RPG with persistent memory across projects.

Status: 0.1.0-alpha — initial bootstrap. API and storage schema are unstable until 1.0.0.

---

What is this?

DevRPG-MCP is a Model Context Protocol server that adds a long-term memory and progression layer to your work with LLM-coding assistants (Claude Code, Cursor, any MCP client). It tracks Quests, Subquests and Tasks; unlocks Perks for capabilities you actually use; stores Resources (domains, VPSes, code templates) and Skills as a layer above your existing skill files.

It is intentionally not a productivity tracker. It is a narrative engine — the agent inside your IDE turns work into a Hero's Journey arc, with a Game Master that observes raw transcripts and applies regulated XP / Karma / Divine Insight rules.

---

Quick start

# install (private repo for now — public after MVP)
pip install git+https://github.com/Zver1013/devrpg-mcp@main

# connect to Claude Code
claude mcp add --scope user devrpg-mcp -- devrpg-mcp

# initialize in current project
devrpg init .

After this, the next time you open Claude Code in a project, the DevRPG tools are available — the agent will use them according to regulations in system/regulations/.

---

Concept

Three roles:

• Operator — you, the human developer
• Agent — the LLM (Claude / GPT / etc.) acting as Game Master
• System — a deterministic sub-agent that audits work and applies XP / Karma rules from raw transcripts

See docs/concepts/system.md for the full philosophy and docs/design/ for technical specs (DB schema, MCP tools API, code-vs-LLM boundary).

---

Tools API

25 MCP tools across 8 categories — character, quest, subquest, task, perk, resource, skill, system, plus universal inventory_check. 24 of them are deterministic Python; one (system_snapshot) spawns a sub-agent for semantic evaluation.

Full reference: docs/design/mcp-tools-api.md.

---

Configuration

Per-project configuration lives in system/config.md (which modules are active, which narrative philosophy applies). Hooks for Claude Code are in templates/hooks.settings.json.

---

License

MIT — see LICENSE.

Author

Nazar Alekseev · zver1013@gmail.com