Minesweeper

🚀 Minesweeper MCP Server

This is a server for the Model Context Protocol, allowing MCP client proxies to interact in the game Minesweeper. It is designed to work with the Minesweeper Game Server.

To view the full video demonstration, visit https://youtu.be/CXXMafVtlEQ (16x speed).

🚀 Quick Start

• Start the local game server by following the instructions.
• Build the MCP server:

npm install
npm run build

• Configure your MCP client to add tools. For example, add the following tools to claude_desktop_config.json on Windows (locate the file), assuming you cloned the repository to 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 load the tools. Make sure to exit via the system tray icon, not from the application itself (which only hides the window). If everything is set up correctly, a new tool should appear when you click the tool icon:

💻 Usage Examples

Basic Usage

Start a new minesweeper game. Try to keep playing until all mines are marked. Remember that coordinates are 0-based.

Advanced Usage

The actual conversation is quite long, and here are just some snippets:

Game Start

Placing a Flag in the Wrong Position

Giving Up After Multiple Attempts