Mindsweeper MCP

🚀 マインスイーパーMCPサーバー

マインスイーパーゲーム機能を提供するModel Context Protocol (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

💻 使用例

基本的な使用法

# 新しいボードを作成する
create_board with id="easy", width=9, height=9, mineCount=10

# セルを開く
reveal_cell on board="easy" at x=4, y=4

# 地雷と疑われるセルに旗を立てる
flag_cell on board="easy" at x=0, y=0

# ボードの状態を確認する
get_board for boardId="easy"

高度な使用法

# 複数のゲームを同時に管理する
# ゲームの勝敗判定とタイミング管理を行う
# ゲームボードをASCIIアートで表示する

ゲームの記号

• . = 未開封のセル
• F = 旗が立てられたセル
• * = 地雷 (ゲーム終了時に表示)
• 1 - 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つのセルにある地雷の数を示します。
• 旗を立てる：地雷があると疑われるセルに旗を立てることで、誤って開くのを防ぎます。
• 自動開放：空のセル（隣接する地雷が0個）を開くと、隣接するすべてのセルが自動的に開かれます。

🔧 技術詳細

プロジェクト構造

src/
├── index.ts          # メインのMCPサーバー実装
└── minesweeper.ts    # コアのゲームロジックと型定義

スクリプト

• npm run build - TypeScriptをJavaScriptにコンパイルします。
• npm run dev - 開発用のウォッチモードです。
• npm start - コンパイルされたサーバーを実行します。

AIアシスタントとの統合

このMCPサーバーは、Model Context ProtocolをサポートするAIアシスタント（Claude Desktopなど）と統合できます。AIは以下のことを支援します。

• 最適な地雷分布でボードを作成する
• 戦略的な手を提案する
• ボードのパターンを分析する
• 複数のゲームを同時に追跡する

📄 ライセンス

MITライセンスです。必要に応じて自由に使用および変更できます！