chrisreddington/turn-based-game-mcp

A turn-based games app built with Next.js and TypeScript that features Tic-Tac-Toe and Rock Paper Scissors games with AI opponents powered by the Model Context Protocol (MCP), offering three difficulty levels.

31 ★25 forksTypeScriptUpdated 23d ago

What you need to know

Demo project showcasing MCP visually: a Next.js 15 turn-based games web app plus an MCP server that acts as an AI opponent (Tic-Tac-Toe and Rock Paper Scissors).

Install

Node.js 18+, npm or pnpm
Clone, npm install, npm run build --workspace=shared (required first)
npm run dev --workspace=web and npm run dev --workspace=mcp-server

Usage

•Use the MCP tools to play games against an AI opponent: create_tic_tac_toe_game, play_tic_tac_toe, create_rock_paper_scissors_game, play_rock_paper_scissors, wait_for_player_move, analyze_game

Key features

✓6 MCP tools for turn-based gameplay
✓Tic-Tac-Toe with Easy/Medium/Hard AI (random, strategic, minimax)
✓Rock Paper Scissors best-of-3 with Random, Adaptive, Pattern-based strategies
✓Next.js 15 + TailwindCSS 4 frontend and API
✓Shared game logic across packages
✓Learning/demo tool, not production-ready
✓MIT license

Best for

Learning how MCP works through an interactive turn-based game demo.

Reviewed 2026-08-11

Topics

aiai-opponentfortheloveofcodegame-developmentmcpmcp-servermodel-context-protocolnextjsturn-based-gamestypescript

Stars: 31★
Forks: 25
Language: TypeScript
License: MIT
Created: 2025-07-30
Last push: 2026-08-12