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.