扫雷游戏服务器

一个让Claude AI通过模型上下文协议(MCP)玩扫雷的游戏服务器,提供实时网页前端展示游戏进度。

  • by AIckathon-2025-08
  • Ruby
  • 本地部署
  • 更新于
在 GitHub 查看 AIckathon-2025-08/clinesweeper

使用说明

MCP诊所

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

目的

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

运行服务器

先决条件

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

快速开始

  1. 构建并运行容器:

    ./deploy.sh
    
  2. 服务器将在以下时间可用 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工具调用进行移动来玩游戏。前端是 只读的 只显示当前状态——你看,克劳德玩!

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

屏幕截图和演示