Horseplay Society MCP
선택 장애를 해결해주는 MCP(Model Context Protocol) 서버입니다.
개요
여러 선택지 중 무엇을 선택해야 할지 고민될 때, 선택지를 입력하면 게임을 통해 결정할 수 있는 URL을 생성해줍니다.
동작 방식
sequenceDiagram
participant User as 사용자
participant LLM as LLM 서비스
participant MCP as Horseplay Society MCP
User->>LLM: "오늘 뭐 먹지?<br/>짬뽕, 짜장면, 울면, 기스면"
LLM->>MCP: pick(<br/>choices: ["짬뽕", "짜장면", "울면", "기스면"])
MCP-->>LLM: https://game.baejji.com?query=...
LLM-->>User: 게임 URL을 통해 선택해보세요!<br/>https://game.baejji.com?query=...
제공하는 Tool
pick
여러 선택지를 받아 게임 URL을 생성합니다.
파라미터:
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
choices | list[str] | O | 선택지 목록 (예: ["짬뽕", "짜장면", "울면", "기스면"]) |
반환값:
선택지가 인코딩된 게임 URL을 반환합니다.
https://game.baejji.com?query={base64_encoded_choices}
사용 예시
- 오늘 뭐 먹지? → 짬뽕, 짜장면, 울면, 기스면
- 주말에 뭐 할까? → 영화보기, 운동하기, 집에서 쉬기, 친구 만나기
- 누가 발표할까? → 철수, 영희, 민수
실행 방법
# 의존성 설치
pip install -r requirements.txt
# 서버 실행
python mcp_server.py
서버는 기본적으로 http://0.0.0.0:8080에서 실행됩니다.
엔드포인트
/health- 헬스체크/mcp- MCP 서버 엔드포인트