# 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

```bash
# 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`](docs/concepts/system.md) for the full philosophy and [`docs/design/`](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`](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`](templates/hooks.settings.json).

---

## License

MIT — see [`LICENSE`](LICENSE).

## Author

Nazar Alekseev · [zver1013@gmail.com](mailto:zver1013@gmail.com)