Mindsweeper MCP

🚀 掃雷MCP服務器

這是一個模型上下文協議（MCP）服務器，提供掃雷遊戲功能。用戶可以創建自定義大小的掃雷棋盤，並通過AI助手來玩經典的掃雷遊戲。

✨ 主要特性

• 自定義棋盤大小：可創建任意大小（最大50x50）的掃雷棋盤。
• 靈活的地雷數量：可設置任意數量的地雷（在合理範圍內）。
• 多局遊戲：管理多個併發的遊戲棋盤。
• 可視化顯示：以ASCII藝術形式展示遊戲棋盤。
• 遊戲狀態跟蹤：檢測勝負並記錄遊戲時間。
• 格子操作：翻開格子、標記或取消標記疑似地雷。

📦 安裝指南

1. 克隆或下載此倉庫。
2. 安裝依賴項：

   npm install
   

3. 編譯TypeScript代碼：

   npm run build
   

4. 啟動服務器：

   npm start
   

📚 詳細文檔

可用工具

create_board

創建一個具有自定義尺寸和地雷數量的新掃雷棋盤。

參數：

• id（字符串）：棋盤的唯一標識符。
• width（數字）：列數（1 - 50）。
• height（數字）：行數（1 - 50）。
• mineCount（數字）：要放置的地雷數量。

示例：

創建一個10x10的棋盤，包含15個地雷，ID為 "game1"

reveal_cell

翻開棋盤上的一個格子。如果是地雷，遊戲結束；如果是空的，相鄰格子可能會自動翻開。

參數：

• boardId（字符串）：棋盤的ID。
• x（數字）：列座標（從0開始）。
• y（數字）：行座標（從0開始）。

示例：

翻開棋盤 "game1" 上位置為 (5, 3) 的格子

flag_cell

標記或取消標記一個格子為疑似地雷。

參數：

• boardId（字符串）：棋盤的ID。
• x（數字）：列座標（從0開始）。
• y（數字）：行座標（從0開始）。

示例：

標記棋盤 "game1" 上位置為 (2, 7) 的格子

get_board

顯示棋盤的當前狀態。

參數：

• boardId（字符串）：要顯示的棋盤的ID。

list_boards

列出所有活躍的遊戲棋盤及其狀態。

參數：無

delete_board

刪除一個遊戲棋盤。

參數：

• boardId（字符串）：要刪除的棋盤的ID。

遊戲符號

• . = 未翻開的格子
• F = 標記的格子
• * = 地雷（遊戲結束時顯示）
• 1 - 8 = 相鄰8個格子中的地雷數量
• （空格） = 周圍沒有地雷的空格子

示例遊戲流程

1. 創建棋盤：

   create_board with id="easy", width=9, height=9, mineCount=10
   

2. 開始翻開格子：

   reveal_cell on board="easy" at x=4, y=4
   

3. 標記疑似地雷：

   flag_cell on board="easy" at x=0, y=0
   

4. 檢查棋盤狀態：

   get_board for boardId="easy"
   

5. 繼續遊戲，直到獲勝或踩到地雷！

遊戲規則

• 目標：翻開所有不包含地雷的格子。
• 獲勝條件：翻開所有非地雷格子。
• 失敗條件：翻開包含地雷的格子。
• 數字：顯示相鄰8個格子中的地雷數量。
• 標記功能：標記你懷疑包含地雷的格子（防止意外翻開）。
• 自動翻開：當你翻開一個空格子（周圍沒有地雷）時，所有相鄰格子會自動翻開。

開發相關

項目結構

src/
├── index.ts          # 主要的MCP服務器實現
└── minesweeper.ts    # 核心遊戲邏輯和類型

腳本命令

• npm run build - 將TypeScript編譯為JavaScript。
• npm run dev - 開發時的監聽模式。
• npm start - 運行編譯後的服務器。

與AI助手集成

此MCP服務器可以與支持模型上下文協議的AI助手集成，如Claude Desktop。AI可以幫助你：

• 創建具有最佳地雷分佈的棋盤。
• 提供戰略建議。
• 分析棋盤模式。
• 同時跟蹤多局遊戲。

📄 許可證

本項目採用MIT許可證，你可以根據需要自由使用和修改！