Minesweeper MCP Server

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

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

An MCP server that enables AI agents like Claude to play Minesweeper through natural language interaction, connecting to a separate Minesweeper game server.

  1. Getting started
    1. Example prompt
      1. Example interaction
        1. Game start
          1. Placing flag at the wrong place
            1. Giving up after several attempts

              Related MCP Servers

              • -
                security
                A
                license
                -
                quality
                An MCP server that generates 2D and 3D game assets from text prompts using AI models from Hugging Face Spaces, allowing developers to easily create game art through Claude Desktop or other MCP clients.
                Last updated a month ago
                34
                JavaScript
                MIT License
                • Apple
                • Linux
              • -
                security
                A
                license
                -
                quality
                An MCP server that helps AI assistants access text content from websites that implement bot detection, bridging the gap between what you can see in your browser and what the AI can access.
                Last updated a month ago
                1
                Python
                Apache 2.0
              • A
                security
                A
                license
                A
                quality
                A Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explore the world, and interact with the game environment through natural language instruction
                Last updated 3 days ago
                14
                47
                TypeScript
                Apache 2.0
                • Apple
              • -
                security
                -
                license
                -
                quality
                A specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.
                Last updated 2 months ago
                31
                1
                TypeScript

              View all related MCP servers

              ID: 9vz18vyg8u