MCP Game Helper

MCP Game Helper

MCP Game Helper は、ゲーム開発者の戦闘バランス調整、スキル分析、レベル進行、シミュレーションに関する作業を支援する、AI 搭載のカスタム Model Context Protocol（MCP）サーバーです。

Cursor との連携を目的に構築されており、公式の @modelcontextprotocol/sdk を使用します

---

🚀 利用可能なコマンド

1. suggest_balancing

2 つのエンティティの HP とダメージを分析し、対戦のバランスが取れているかを評価します。

入力例：

{
  "player": { "hp": 2040, "damage": 1500 },
  "enemy": { "hp": 2080, "damage": 1000 }
}

プロンプト例：

I want to check if my player and enemy are balanced.
Player: 2040 HP, 1500 DMG
Enemy: 2080 HP, 1000 DMG

---

2. simulate_combat

戦闘シナリオをシミュレートし、両方のエンティティのキルまでの時間（TTK）を推定します。

入力例：

{
  "player": { "hp": 100, "damage": 10, "attackSpeed": 1.0 },
  "enemy": { "hp": 80, "damage": 20, "attackSpeed": 0.5 }
}

プロンプト例：

Simulate a fight:
Player has 100 HP, 10 DMG, 1.0 attack speed
Enemy has 80 HP, 20 DMG, 0.5 attack speed

---

3. simulate_room_survival_time

複数の敵との戦闘でプレイヤーがどれだけ生き残れるか、また部屋をクリアするのにかかる時間を推定します。

入力例：

{
  "player": { "hp": 100, "damage": 15, "attackSpeed": 1.2 },
  "enemies": [
    { "hp": 40, "damage": 10, "attackSpeed": 0.8 },
    { "hp": 50, "damage": 12, "attackSpeed": 1.0 }
  ]
}

プロンプト例：

How long will my player survive in a room?
Player: 100 HP, 15 damage, 1.2 speed
Enemies: One with 40 HP, 10 damage, 0.8 speed, another with 50 HP, 12 damage, 1.0 speed

---

4. simulate_skill_impact

ダメージ、効果範囲、クールダウンに基づいて、スキルの有効性をシミュレートします。

入力例：

{
  "skill": {
    "damage": 80,
    "cooldown": 5,
    "area": 3
  },
  "enemies": [{ "hp": 100 }, { "hp": 80 }, { "hp": 60 }]
}

プロンプト例：

My skill deals 80 damage, has 5s cooldown, and hits 3 enemies.
Enemy HPs: 100, 80, 60
How good is this skill?

---

5. suggest_difficulty_ramp

レベル間の進行を分析し、難易度の上昇が緩やかか急激かについてフィードバックを提供します。

入力例：

{
  "levels": [
    { "name": "Forest", "enemyHp": 50 },
    { "name": "Cave", "enemyHp": 80 },
    { "name": "Castle", "enemyHp": 120 }
  ],
  "player": { "damage": 25, "attackSpeed": 1.0 }
}

プロンプト例：

My player deals 25 dmg/sec.
Forest enemies: 50 HP
Cave: 80 HP
Castle: 120 HP
Is this difficulty curve balanced?

---

6. predict_performance_impact

コードスニペットをスキャンし、潜在的なパフォーマンス上の問題についてフィードバックを提供します。

入力例：

{
  "code": "for (let i = 0; i < 10000; i++) { this.spawnEnemy(); }"
}

プロンプト例：

Can you check this code for performance issues?

for (let i = 0; i < 10000; i++) {
  this.spawnEnemy();
}

Also, I sometimes use setInterval inside update(). Is that bad?

---

7. suggest_ai_state_machine

自然言語で記述された振る舞いに基づいて、AI のステートマシン案を作成します。

入力例：

{
  "description": "This enemy walks around the map until it sees the player, then it chases them. If close enough, it attacks. If it loses sight, it goes back to patrolling."
}

プロンプト例：

This enemy walks around the map until it sees the player, then it chases them.
If close enough, it attacks. If it loses sight, it goes back to patrolling.
Can you suggest a state machine?

---

8. suggest_wave_timing

プレイヤーの DPS と敵の HP に基づいて、敵のウェーブ間の最適な時間を提案します。

入力例：

{
  "player": { "damage": 30, "attackSpeed": 2 },
  "enemyHp": 100,
  "enemiesPerWave": 3
}

プロンプト例：

My player deals 30 damage per hit and attacks twice per second.
Each enemy has 100 HP, and I spawn 3 enemies per wave.
What should be the ideal time between waves?

---

🛠 ローカルでの実行方法

1. 依存関係をインストールします：

npm install

2. プロジェクトをビルドします：

npm run build

3. パッケージをグローバルにインストールします：

npm install -g .

4. .cursor-config.json にサーバーを登録してください：

{
  "mcpServers": {
    "mcp-game-helper": {
      "command": "npx",
      "args": ["-y", "mcp-game-helper"]
    }
  }
}

---

💡 コントリビューション

ゲーム開発者に役立つ新しいコマンドの提案を歓迎します。特に、AI、バランス調整、シミュレーションに関するものをお待ちしています！

---

📘 ライセンス

MIT