La Mano de la Adivina — un servidor MCP de rol

Un servidor MCP que actúa como juego de rol y director de juego usando las reglas de La Mano de la Adivina, un juego de rol de mesa original en el que estoy trabajando actualmente. Claude lee las cartas, lanza los presagios y dirige la mesa; el jugador y Claude se turnarán para narrar la historia que se desarrolla.

Cómo se siente jugar

Una versión breve, antes de que instales nada: te sientas primero con la Adivina — el lugar donde la conoces es la única elección que se hace antes de que se extraiga cualquier carta. Cuatro palos se convierten en cuatro facetas de quién eres; la Adivina extrae una carta de cada uno y dice lo que revela, y tú construyes un personaje a partir de esas cuatro frases. Una vez que tienes tu personaje, debes interpretar tu carta de Meta antes de partir.

A partir de ahí, cada escena funciona igual: decide dónde estás, voltea una carta para ver qué se agita, narra hacia adelante. En el momento en que la historia llega a otro corazón, algo oculto, o necesita un giro de suerte, te detienes y le preguntas al destino directamente invocando un Presagio. El destino también puede volverse en tu contra; cuando lo hace, puedes luchar contra él.

En el fondo, es un juego de escritura creativa. El verdadero placer está en la narración que tú y la Adivina construyen juntos, no en ganar nada. Motivación, Fines, Buscar y Cargar no son reglas que obedecer; son semillas, cuatro puntos de partida para la psicología de tu personaje y la forma de la historia que viene. Síguelas hacia donde te lleven, o deja que la historia vague hacia otro lugar. Cuanto más describas, más te devuelve la historia.

Esa es su forma. Mecánicas completas en RULES.md; un recorrido más suave y completo en HOW_TO_PLAY.md; una transcripción completa de una sesión real en 08-2026-Play-Example.md. Si alguna vez pierdes el rastro de tu Meta o de tus cuatro facetas a mitad de una historia, solo pídele a la Adivina que te lo recuerde.

Related MCP server: mcp-tarot-draw

Cómo ejecutarlo

Instalación rápida

1. Guarda learnMCP.mcpb en algún lugar que puedas encontrar.

2. Haz doble clic en él (no lo arrastres a una ventana de chat — solo haz doble clic en el archivo mismo). Se abrirá un aviso de instalación en Claude Desktop.

3. Confirma la instalación.

4. Cierra y vuelve a abrir Claude Desktop por completo.

5. Inicia un nuevo chat y usa el prompt start_game — te pedirá un nombre de personaje, y luego estás listo.

Ejecutar desde el código fuente

Requiere Python y uv.

1. uv sync dentro de este directorio.

2. En Claude Desktop: Configuración → Desarrollador → Editar configuración, y añade:

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

3. Cierra y reinicia Claude Desktop por completo.

4. Haz clic en el icono + cerca del cuadro de mensaje → Conectores → habilita "fortuneteller".

5. Inicia un nuevo chat y usa el prompt start_game.

6. Cuando te pida el nombre de tu personaje (player_name), complétalo.

7. Una vez que el prompt se adjunte como una etiqueta sobre el cuadro de mensaje, haz clic en enviar o pulsa enter — adjuntarlo no lo envía por sí solo.

Influencias

Este proyecto se inspira en algunos lugares. La lectura de dos dados de los Presagios, comparando en lugar de sumando, debe mucho a Ironsworn de Shawn Tomkin, que me encanta absolutamente. El ritual de Desafío, "No así", toma su forma de cinco dados, tres tiradas, quédate con lo que quieras del Yahtzee (que fue robado del juego puertorriqueño "Jenerala"). Como juego de escritura, debe mucho a Thousand Year Old Vampire de Tim Hutchings, uno de los juegos que demostró que el juego en solitario, impulsado por prompts, podía tener un peso real. ¡Un juego increíble! Y finalmente, Max Moon ha dado forma al tono de este proyecto en todo momento. Adoro todo lo que crea Max Moon.

¿Tienes curiosidad sobre la construcción?

Esto comenzó como una forma de aprender el Model Context Protocol de una manera que me interesara. Las elecciones de herramientas/recursos/prompts, el diseño del estado, algunos errores reales encontrados y corregidos en el camino, todo está documentado en DESIGN.md. Si tienes alguna pregunta o deseas que arregle o añada algo, por favor contáctame.

Política de privacidad

• Recopilación de datos: Este MCP no recopila nada.

• Uso y almacenamiento: No se almacena nada. Todo el estado del juego (tu personaje, cartas extraídas, deuda pendiente) existe solo en memoria durante la duración de tu sesión y se descarta cuando termina.

• Compartir con terceros: No se comparte nada con ningún tercero, porque no se recopila nada en primer lugar.

• Retención de datos: No se retiene nada.

• Información de contacto: maria@mariasaha.com