clinesweeper (A Ickathon 2025 08)

MCP诊所

扫雷游戏服务器，允许您的Claude AI通过模型上下文协议（MCP）玩扫雷游戏。

目的

这个项目允许克劳德（或其他兼容MCP的AI助手）玩扫雷游戏。AI通过MCP界面进行移动，您可以在web前端实时查看游戏进度。

运行服务器

先决条件

• 已安装Docker或Podman
• 端口3100可用

快速开始

1. 构建并运行容器：

   ./deploy.sh

1. 服务器将在以下时间可用 http://localhost:3100

这 deploy.sh 脚本会自动检测您是否安装了Docker或Podman，并使用相应的工具。

MCP配置

要将Claude连接到Clinesweeper，您需要在Claude客户端中配置MCP服务器。

对于光标

编辑 ~/.cursor/mcp.json 并添加：

{
  "mcpServers": {
    "clinesweeper": {
      "url": "http://localhost:3100/mcp",
      "transport": {
        "type": "streamable-http"
      }
    }
  }
}

适用于克劳德桌面

macOS： 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json

窗户： 编辑 %APPDATA%\Claude\claude_desktop_config.json

添加与上述相同的配置。

更新配置后，重新启动Claude客户端以连接到MCP服务器。

运作原理

• 后端：Rails API服务器，实现扫雷游戏逻辑并通过MCP（JSON-RPC 2.0）公开该逻辑
• 前端：通过WebSockets显示当前游戏状态的实时web界面
• 游戏玩法：AI助手（Claude）通过MCP工具调用进行移动来玩游戏。前端是 只读的 只显示当前状态——你看，克劳德玩！

随着人工智能的移动，前端会实时更新，因此您可以随着游戏的进展而跟随游戏。

屏幕截图和演示

• Live Minesweeper board
• 观看游戏演示 Google 云端硬盘.