운명술사의 손 — RPG MCP 서버

The Fortuneteller's Hand의 규칙을 사용하는 롤플레잉 게임이자 GM 역할을 하는 MCP 서버입니다. 제가 현재 작업 중인 오리지널 테이블톱 RPG입니다. 클로드가 카드를 읽고, 징조를 점치고, 테이블을 운영합니다. 플레이어와 클로드는 번갈아 가며 전개되는 이야기를 서술합니다.

플레이 경험

간단히 설명하자면, 무엇을 설치하기 전에 먼저 운명술사와 마주 앉습니다. 어디서 만날지는 카드를 뽑기 전에 내리는 유일한 선택입니다. 네 가지 문양은 당신이라는 존재의 네 가지 측면이 됩니다. 운명술사는 각각에서 카드 한 장을 뽑아 그 의미를 말하고, 당신은 그 네 문구로 캐릭터를 만듭니다.

캐릭터가 생겼다면, 길을 떠나기 전에 목표 카드를 해석해야 합니다.

그 후의 모든 장면은 같은 방식으로 진행됩니다. 현재 위치를 정하고, 카드를 뒤집어 무슨 일이 일어나는지 확인하고, 이야기를 이어 나갑니다. 이야기가 또 다른 핵심에 도달하거나, 숨겨진 무언가에 닿거나, 행운의 전환이 필요해지는 순간, 멈추고 징조를 불러 운명에게 직접 물어보세요. 운명이 당신에게 등을 돌릴 수도 있습니다. 그럴 때는 맞서 싸울 수 있습니다.

이 게임은 본질적으로 창의적인 저널링 게임입니다. 진정한 즐거움은 이기는 것이 아니라 당신과 운명술사가 함께 만들어 가는 서사에 있습니다. 동기, 목적, 추구, 짐은 지켜야 할 규칙이 아니라 씨앗과도 같은 것으로, 캐릭터의 심리와 앞으로 펼쳐질 이야기의 방향을 위한 네 가지 출발점입니다. 그 인도하는 대로 따라가든, 이야기가 다른 곳으로 흘러가게 두든 상관없습니다. 더 많이 묘사할수록 이야기는 더 풍성해집니다.

이것이 전체적인 구성입니다. 전체 메커니즘은 RULES.md에, 더 자세하고 친절한 안내는 HOW_TO_PLAY.md에, 실제 플레이 기록 전문은 08-2026-Play-Example.md에 있습니다. 이야기를 진행하다가 목표나 네 가지 측면을 잊어버려도 운명술사에게 상기시켜 달라고 하면 됩니다.

Related MCP server: mcp-tarot-draw

실행하기

빠른 설치

1. learnMCP.mcpb를 찾기 쉬운 곳에 저장합니다.

2. 파일을 더블클릭합니다(채팅 창에 끌어다 놓지 말고 파일 자체를 더블클릭하세요). Claude Desktop에 설치 프롬프트가 열립니다.

3. 설치를 확인합니다.

4. Claude Desktop을 완전히 종료하고 다시 엽니다.

5. 새 채팅을 시작하고 start_game 프롬프트를 불러옵니다. 캐릭터 이름을 묻는 메시지가 표시되면 입력하면 됩니다.

소스에서 실행

Python과 uv가 필요합니다.

1. 이 디렉토리에서 uv sync를 실행합니다.

2. Claude Desktop에서 설정 → 개발자 → 구성 편집으로 이동하여 다음을 추가합니다:

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

3. Claude Desktop을 완전히 종료하고 다시 시작합니다.

4. 메시지 상자 근처의 + 아이콘을 클릭 → 커넥터 → "fortuneteller"를 활성화합니다.

5. 새 채팅을 시작하고 start_game 프롬프트를 불러옵니다.

6. 캐릭터 이름(player_name)을 묻는 메시지가 표시되면 입력합니다.

7. 프롬프트가 메시지 상자 위에 칩으로 표시되면 보내기 버튼을 클릭하거나 Enter 키를 누릅니다. 칩을 추가하는 것만으로는 전송되지 않습니다.

영향

이 프로젝트는 여러 곳에서 영감을 받았습니다. 징조의 두 주사위 판독(합산이 아닌 비교 방식)은 제가 정말 사랑하는 Shawn Tomkin의 아이언스웜의 영향을 크게 받았습니다. 저항 의식인 "Not Like This"는 다섯 개의 주사위를 세 번 굴려 원하는 주사위를 유지하는 방식으로, 야츠키(푸에르토리코 게임 "Jenerala"에서 유래)에서 차용했습니다. 저널링 게임으로서 이 프로젝트는 Tim Hutchings의 천 년 된 뱀파이어의 영향을 많이 받았습니다. 혼자서 프롬프트 기반 플레이가 진정한 무게를 실을 수 있음을 증명한 게임 중 하나입니다. 정말 대단한 게임이에요! 마지막으로 Max Moon은 이 프로젝트 전반에 걸쳐 톤을 형성하는 데 큰 영향을 주었습니다. Max Moon이 만드는 모든 것을 사랑합니다.

빌드가 궁금하신가요?

이 프로젝트는 제가 흥미를 가질 만한 방식으로 Model Context Protocol을 배우기 위한 시도에서 시작되었습니다. 도구/리소스/프롬프트 선택, 상태 설계, 그 과정에서 발견하고 수정한 몇 가지 실제 버그에 대한 모든 것이 DESIGN.md에 정리되어 있습니다. 질문이 있거나 수정하거나 추가할 사항이 있으면 연락 주시기 바랍니다.

개인정보 처리방침

• 데이터 수집: 이 MCP는 어떤 데이터도 수집하지 않습니다.

• 사용 및 보관: 아무것도 저장하지 않습니다. 모든 게임 상태(캐릭터, 뽑은 카드, 진 빚)는 세션이 유지되는 동안에만 메모리에 존재하며, 세션이 종료되면 폐기됩니다.

• 제3자 제공: 어떤 제3자와도 공유하지 않습니다. 애초에 수집하는 것이 없기 때문입니다.

• 데이터 보유: 보관하는 데이터가 없습니다.

• 연락처: maria@mariasaha.com