Minesweeper

About

Minesweeper is a stdio MCP (Multi-Modal Command Protocol) server designed to interface AI hosts like Claude Code or Claude Desktop with a Rails 8 Minesweeper Web/API. It acts as a bridge, allowing AI to control the game by issuing commands such as `start`, `open`, `flag`, `chord`, and `end` via the game's REST API. This tool facilitates the development and testing of AI agents for Minesweeper, providing a standardized communication channel for automated gameplay.

Key Features

• Stdio-based communication for MCP hosts
• Controls Minesweeper game state via REST API calls (start, open, flag, chord, end)
• Supports local development via Node.js and deployment via npx
• Logs output exclusively to stderr to maintain clean MCP protocol communication
• 2 GitHub stars
• Configurable with environment variables for API base URL and bearer token

Use Cases

• Integrating AI models (e.g., Claude Code/Desktop) with a web-based Minesweeper game
• Developing and testing AI agents to play Minesweeper
• Automating Minesweeper gameplay for strategic analysis or performance evaluation