Minesweeper MCP Server

What is Minesweeper MCP Server?

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.

How to use Minesweeper MCP Server?

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.

Key features of Minesweeper MCP Server

• 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.

Use cases of Minesweeper MCP Server

• Testing and demonstrating how MCP agents handle turn‑based games.
• Evaluating an AI's logical reasoning and planning in a deterministic puzzle.
• Adding interactive game capabilities to a Claude Desktop or similar MCP client.

FAQ from Minesweeper MCP Server

What does the server do?

It exposes Minesweeper game actions as MCP tools, allowing an agent to play the game through the MCP client.

What are the runtime requirements?

Node.js and npm are needed to build and run the server. The separate Minesweeper game server must also be running locally.

Where does game state live?

Game state is managed entirely by the running game server, not by this MCP server.

How is the server connected to the MCP client?

It uses a standard MCP transport via a child process (the node command), configured in the client’s settings (e.g., claude_desktop_config.json).

Are there known limits or authentication?

—