minesweeper-mcp-server
by: tonypan2
An MCP server for playing Minesweeper
📌Overview
Purpose: To provide an MCP server that enables client agents to interactively play the game of Minesweeper within a structured protocol environment.
Overview: The Minesweeper MCP Server is designed to work in conjunction with the Minesweeper game server, facilitating an interactive gaming experience where agents can participate in the classic puzzle game. It is built using Node.js, allowing for easy configuration and integration with various client applications.
Key Features:
-
MCP Protocol Compliance: Ensures effective communication between client agents and the server, adhering to the Model Context Protocol specifications to create a seamless gameplay experience.
-
Client Integration: Allows for straightforward configuration with any MCP-compatible client, providing a plug-and-play setup to enhance existing applications with Minesweeper gameplay capabilities.
Minesweeper MCP Server
This is a Model Context Protocol server that allows 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: https://github.com/tonypan2/minesweeper-server
-
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
, assuming you cloned the repo atC:\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: