turn-based-game-mcp

Overview

This project is a demo showcasing MCP implementation in a turn-based games context. It features a Next.js frontend with a clean UI and a dedicated MCP server that provides AI opponents for games. The server implements specific MCP tools for game creation, AI moves, and game analysis, with multiple difficulty levels. While presented as a demo, it's well-structured with comprehensive documentation, TypeScript throughout, and a clear separation of concerns between web interface and MCP server logic.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• create_tic_tac_toe_game

  Create new Tic-Tac-Toe game

  Try:Start a new Tic-Tac-Toe gameTry:Create a Tic-Tac-Toe match with medium difficulty
• play_tic_tac_toe

  Make AI move in Tic-Tac-Toe

  Try:Make your move in the Tic-Tac-Toe gameTry:Play as AI in the current Tic-Tac-Toe match
• create_rock_paper_scissors_game

  Create new Rock Paper Scissors game

  Try:Start a new Rock Paper Scissors gameTry:Create a Rock Paper Scissors match with adaptive AI
• play_rock_paper_scissors

  Make AI choice in Rock Paper Scissors

  Try:Make your move in the Rock Paper Scissors gameTry:Play as AI in the current Rock Paper Scissors match
• wait_for_player_move

  Wait for human player to make their move

  Try:Wait for the player to make their moveTry:Pause until the human player takes their turn
• analyze_game

  Analyze current game state and provide insights

  Try:Analyze the current game stateTry:Provide insights about the game progress

Comparable tools

Installation

git clone https://github.com/github-samples/turn-based-game-mcp.git
cd turn-based-game-mcp

npm install

npm run build --workspace=shared

npm run dev --workspace=web

npm run dev --workspace=mcp-server

{
  "mcpServers": {
    "turn-based-games": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "./turn-based-game-mcp/mcp-server"
    }
  }
}

FAQ

Is this a production-ready application?

No, this is intended as a demo to showcase MCP implementation visually, not as a production application.

What MCP tools are available?

The server provides tools for creating games (Tic-Tac-Toe and Rock Paper Scissors), making AI moves, waiting for player moves, and analyzing game states.

Compare turn-based-game-mcp with