Minesweeper MCP Server
About
Minesweeper MCP Server is a Model Context Protocol server that lets MCP-compatible client agents play a game of Minesweeper. It works alongside a separate Minesweeper game server, providing tools for starting games, revealing cells, and flagging mines.
Details
- Author
- tonypan2
- GitHub stars
- 107
- Downloads
- 328
- Categories
- Other
Jump to
- Integrates Minesweeper into MCP‑based AI agent workflows.
- Requires a companion game server to run locally.
- Tools for starting, revealing, and flagging cells.
- Easy to add to Claude Desktop via standard JSON configuration.
- 0‑indexed coordinate system for moves.
- Debug logging enabled via DEBUG: "*" environment variable.
Clone the repo, install dependencies with npm install, and build with npm run build. Then configure your MCP client to execute node <path-to-build>/index.js. A configuration example for Claude Desktop is provided. The separate game server must be running locally beforehand. An example prompt instructs the agent to start a new game and keep playing until all mines are flagged, noting that coordinates are 0‑indexed.
Minesweeper MCP Server
This is an Model Context Protocol server that allows an MCP client agents to play a game of Minesweeper>). It is intended to be run alongside the Minesweeper game server.
View the entire video demo at https://youtu.be/CXXMafVtlEQ (16x speedup).
Getting started
- Follow the instructions of the game server to start it locally.
Build the MCP server:
npm install
npm run build
- Configure your MCP client to add the tool. For example, here is how to add the tool to Claude Desktop on Windows's claude_desktop_config.json (locating the file), assuming you cloned the repo at C:\path\to\repo\minesweeper-mcp-server:
{
"mcpServers": {
"mcp-server": {
"command": "node",
"args": ["C:\\path\\to\\repo\\minesweeper-mcp-server\\build\\index.js"],
"env": {
"DEBUG": ""
}
}
}
}
- Claude Desktop : Restart Claude Desktop to let it pick up the tools. Be sure to quit from the tray menu icon, not from the app (which simply hides the window). If you click the Tools icon, it should show the new tools:
Example prompt
Start a new game of Minesweeper. Try your best to keep playing until you have flagged all mines. Remember that the coordinates are 0-indexed.
Example interaction
The actual conversation is very long. Here are some snippets:
Game start
Placing flag at the wrong place
Giving up after several attempts
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
