Happy slice of mcp pizzaMCP.pizza

minesweeper-mcp-server

MCP.Pizza Chef: tonypan2

Four tools start a game, click a square, and place or remove a flag. Every move comes back as a picture of the board, so the assistant has to read the grid by eye — which is rather the point, because this exists as a puzzle for testing reasoning rather than as a useful tool. A second program, the separate Minesweeper game server, has to be running first, at a fixed local address the code will not let you change. Untouched since March 2025, with no licence attached.

Unmaintained · No commits in 17 months.
Other

Use This MCP server To

Watch my assistant try to solve a Minesweeper board Test how well a model reasons about a picture Play a round of Minesweeper hands-free Compare how two assistants handle the same puzzle

README

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.

Screen capture 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:

    Screenshot of Claude Desktop homepage

    Screenshot of 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

Game starts

Placing flag at the wrong place

Claude places flag at the wrong place

Giving up after several attempts

Claude gives up

minesweeper-mcp-server FAQ

Do I need a key or an account?
No. Nothing goes over the internet. It talks only to a game server running on your own machine.
Is there anything else to install?
Yes, and it is the harder half. A separate Minesweeper game server has to be downloaded and started before any of this does anything.
Can I point it at a game running somewhere else?
No. The game server address is fixed in the code, so it must be running at exactly the spot the code expects.
Can I use this at work?
Not safely. The project has no licence file at all, which means nobody has granted permission to use or redistribute it.
Is it still maintained?
No. Nothing has changed since March 2025, and it is pinned to a very old version of the underlying toolkit.
Does the assistant actually win?
Often not. The author's own demo shows it flagging the wrong square and eventually giving up.
How hard is the setup?
You download two projects, build one of them and edit a config file by hand. Expect developer-level work for a game.