wtf is game-master-mcp?

Game Master is a small local server that lets you actually play board games against an AI, instead of just describing moves and hoping the AI keeps track correctly. It handles six games: tic tac toe, Connect Four, checkers, backgammon, chess, and Battleship. Each game has its full rules built in, so things like mandatory jumps in checkers, castling and check in chess, or hidden ships in Battleship are enforced by the server itself rather than trusted to memory. The server speaks a protocol called MCP, which lets AI assistants like Claude connect to outside tools. Once you install it with a short command, your AI can start a game, and the two players are always called human and agent. Every finished match gets saved automatically to a running ledger that tracks wins, streaks, and the longest games played, and your AI can add a title and a short note to each match afterward. Alongside the AI connection, there is an optional web interface called the Game Room. Running a second small script opens a local webpage showing all six games sitting on a shelf, with the match history displayed underneath. Clicking a game lets you play as the human player on your own dedicated board, so games you are playing purely through conversation with your AI stay separate and undisturbed. The web page and the AI's moves both read and write the same saved game files, so a move your AI makes shows up on your screen right away. You can personalize the setup with your own name, a name for your AI, and a color theme, either through a config file or environment variables. If you also run a compatible local chat server, the Game Room can show a live chat panel next to the board for back and forth conversation while you play, and without it, that panel just explains it is not connected while the rest of the app works the same. For fairness, the server never lets the browser make a move for the AI or the other way around, and in Battleship each side only ever sees its own ships along with the hits and misses from its own shots, never the other player's hidden fleet. The project is written in Python, requires Python 3.10 or newer, and is released under the MIT license.