2048mcp

# 2048 游戏与 MCP 服务器的 AI 控制 本项目提供了一个基于 GUI 的 2048 游戏，带有 RESTful API，以及一个 MCP（模型-控制器-玩家）服务器，允许 AI 代理以编程方式控制游戏。 ## 组件 - **图形用户界面游戏**：使用 Tkinter 构建的 2048 游戏的可视化实现 - **RESTful API**：基于 Flask 的 API，用于与游戏交互 - **MCP 服务器**：基于 fastmcp 的服务器，暴露用于 AI 控制的标准化端点 ## 需求 ``` Flask>=2.0 fastmcp>=0.2.0 numpy>=1.20.0 requests>=2.25.0 ``` ## 安装 1. 克隆此仓库 2. 安装所需的软件包： ``` pip install -r requirements.txt ``` ## 使用 ### 启动游戏和 API 要启动带有 RESTful API 的 2048 游戏： ``` python main.py ``` 这将： - 启动显示 2048 游戏的 GUI 窗口 - 在 http://127.0.0.1:5000 启动 RESTful API 服务器 - 允许手动播放（通过 GUI）和基于 API 的控制 ### 启动 MCP 服务器 要启动用于 AI 控制的 MCP 服务器： ```json "mcpServers": { "2048_game": { "name": "2048 游戏", "type": "stdio", "description": "2048 游戏控制 MCP", "isActive": true, "command": "uv", "args": [ "--directory", "/directory/to/your/python_script", "run", "mcp_server.py" ] } } ``` 这将： - 启用 MCP 服务器 ## API 端点 ### 游戏 RESTful API（端口 5000） - `GET /status`: 返回当前游戏状态 - `POST /move/{direction}`: 按指定方向进行移动（'up', 'down', 'left', 'right'） - `POST /reset`: 将游戏重置为其初始状态 ## 许可证 本项目是开源的。您可以自由修改和分发。