The Fortuneteller's Hand — ein RPG-MCP-Server

Ein MCP-Server, der als Rollenspiel und Spielleiter (GM) fungiert und die Regeln von The Fortuneteller's Hand verwendet, einem originellen Tabletop-Rollenspiel, an dem ich derzeit arbeite. Claude liest die Karten, wirft die Omen und leitet die Runde; Spieler und Claude erzählen abwechselnd die Geschichte, die sich entwickelt.

Wie sich das Spielen anfühlt

Eine Kurzfassung, bevor du etwas installierst: Du setzt dich zuerst mit dem Wahrsager zusammen – wo ihr euch trefft, ist die einzige Wahl, die getroffen wird, bevor eine Karte gezogen wird. Vier Farben werden zu vier Facetten deiner selbst; der Wahrsager zieht aus jeder eine Karte und spricht aus, was sie offenbart, und du baust aus diesen vier Sätzen einen Charakter. Sobald du deinen Charakter hast, musst du deine Goal-Karte deuten, bevor du aufbrichst.

Von dort an funktioniert jede Szene auf dieselbe Weise: Du entscheidest, wo du bist, deckst eine Karte auf, um zu sehen, was sich regt, und erzählst weiter. Sobald die Geschichte ein weiteres Herz erreicht, etwas Verborgenes auftaucht oder eine Glückswende nötig ist, hältst du inne und fragst das Schicksal direkt, indem du ein Omen rufst. Das Schicksal kann sich auch gegen dich wenden; wenn es das tut, kannst du dich dagegen wehren.

Im Kern ist dies ein kreatives Journaling-Spiel. Die eigentliche Freude liegt in der Erzählung, die du und der Wahrsager gemeinsam gestalten, nicht im Gewinnen. Motivation, Ends, Seek und Carry sind keine Regeln, die du befolgen musst; sie sind Samen, vier Ausgangspunkte für die Psychologie deines Charakters und die Form der Geschichte, die vor dir liegt. Folge ihnen, wohin sie führen, oder lass die Geschichte woandershin wandern. Je mehr du beschreibst, desto mehr gibt die Geschichte zurück.

So sieht das Ganze aus. Die vollständige Mechanik findest du in RULES.md; eine sanftere, ausführlichere Anleitung in HOW_TO_PLAY.md; ein vollständiges Transkript einer echten Sitzung in 08-2026-Play-Example.md. Wenn du mitten in einer Geschichte dein Goal oder deine vier Facetten aus den Augen verlierst, bitte den Wahrsager einfach, dich daran zu erinnern.

Related MCP server: mcp-tarot-draw

Ausführen

Schnellinstallation

1. Speichere learnMCP.mcpb an einem auffindbaren Ort.

2. Doppelklicke darauf (zieh es nicht in ein Chat-Fenster — doppelklicke einfach die Datei selbst). Es öffnet sich ein Installationsdialog in Claude Desktop.

3. Bestätige die Installation.

4. Beende Claude Desktop vollständig und öffne es erneut.

5. Starte einen neuen Chat und binde den start_game-Prompt ein — er fragt nach einem Charakternamen, dann kann es losgehen.

Aus dem Quellcode ausführen

Erforderlich sind Python und uv.

1. Führe uv sync in diesem Verzeichnis aus.

2. In Claude Desktop: Einstellungen → Entwickler → Konfiguration bearbeiten, und füge hinzu:

   {
     "mcpServers": {
       "fortuneteller": {
         "command": "uv",
         "args": ["run", "--directory", "/absolute/path/to/learnMCP", "main.py"]
       }
     }
   }

3. Beende Claude Desktop vollständig und starte es neu.

4. Klicke auf das +-Symbol neben dem Nachrichtenfeld → Connectors → aktiviere „fortuneteller“.

5. Starte einen neuen Chat und binde den start_game-Prompt ein.

6. Wenn nach dem Namen deines Charakters gefragt wird (player_name), trage ihn ein.

7. Sobald der Prompt als Chip über dem Nachrichtenfeld angehängt ist, klicke auf Senden oder drücke die Eingabetaste — das Anhängen übermittelt ihn nicht von selbst.

Einflüsse

Dieses Projekt schöpft aus einigen Quellen. Die Zwei-Würfel-Lesung der Omen, die vergleicht statt summiert, verdankt Ironsworn von Shawn Tomkin eine Menge, das ich absolut LIEBE. Das Defiance-Ritual „Not Like This“ entlehnt seine Form – fünf Würfel, drei Würfe, behalten, was man will – von Yahtzee (das wiederum vom puertoricanischen Spiel „Jenerala“ gestohlen wurde). Als Journaling-Spiel verdankt dieses Projekt Thousand Year Old Vampire von Tim Hutchings viel, einem der Spiele, die bewiesen haben, dass Solo- und promptgesteuertes Spielen echtes Gewicht haben kann. Unglaubliches Spiel! Und schließlich hat Max Moon den Ton dieses Projekts durchgehend geprägt. Ich liebe alles, was Max Moon erschafft.

Neugierig auf den Aufbau?

Das begann als eine Möglichkeit, das Model Context Protocol auf eine Weise zu lernen, die mich interessiert. Die Auswahl der Tools/Ressourcen/Prompts, das Design des Spielzustands, ein paar echte Bugs, die unterwegs gefunden und behoben wurden – all das ist in DESIGN.md beschrieben. Wenn du Fragen hast oder möchtest, dass ich etwas repariere oder hinzufüge, kontaktiere mich bitte.

Datenschutzerklärung

• Datenerfassung: Dieser MCP-Server erfasst nichts.

• Nutzung und Speicherung: Es wird nichts gespeichert. Der gesamte Spielzustand (dein Charakter, gezogene Karten, bestehende Schulden) existiert nur im Speicher für die Dauer deiner Sitzung und wird verworfen, wenn sie endet.

• Weitergabe an Dritte: Es wird nichts an Dritte weitergegeben, weil von vornherein nichts erfasst wird.

• Datenaufbewahrung: Es wird nichts aufbewahrt.

• Kontaktinformationen: maria@mariasaha.com