Raid Shadow Legends MCP Server

Raid Shadow Legends MCP サーバー

Mission Control Protocol サーバーを介して、Raid Shadow Legends の Tasker オートメーションを制御します。

概要

このプロジェクトは、Raid Shadow Legends の Tasker オートメーションと連携する MCP サーバーを提供します。次のことができます。

• MCP ツールを介して Raid Shadow Legends のオートメーションを制御する
• REST API を介してオートメーションの目標を設定する
• MQTT を介してゲームのステータスを監視する
• Tasker プロジェクトと連携する

前提条件

• Node.js 18+
• ポート 9900 で稼働している MQTT ブローカー
• Raid オートメーションプロジェクトを設定した Android デバイスに Tasker がインストールされていること
• Tasker プロジェクトで MQTT トピックをリッスンするよう設定されていること

インストール

# Clone the repository
git clone https://github.com/yourusername/RaidShadowLegendsButItsMCP.git

# Navigate to the project directory
cd RaidShadowLegendsButItsMCP

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

設定

MCP サーバーは MQTT ブローカーに接続して Tasker と通信します。デフォルトでは、次のアドレスに接続します。

http://localhost:9900/mqtt

変更するには、src/index.ts と src/RaidShadowLegendsButItsMCP.ts の両方にある MQTT_SERVER_URL を変更してください。

API の使用方法

REST API

ステータスの取得

GET /api/status

レスポンス：

{
  "lastUpdate": "2023-11-01T12:34:56.789Z",
  "raidStatus": "running",
  "raidProgress": 75,
  "battleCount": 3,
  "energyRemaining": 84,
  "timestamp": "2023-11-01T12:35:00.123Z"
}

コマンドの送信

POST /api/command

リクエストボディ：

{
  "command": "raid_start",
  "parameters": {
    "mode": "campaign",
    "stage": 12
  }
}

レスポンス：

{
  "success": true,
  "message": "Command raid_start sent successfully"
}

目標の設定

POST /api/goal

リクエストボディ：

{
  "battleCount": 20,
  "battleType": "campaign",
  "autoSell": true,
  "energyRefill": false
}

レスポンス：

{
  "success": true,
  "message": "Goal set: 20 campaign battles"
}

MCP ツール

サーバーは次の MCP ツールを提供します。

• RaidShadowLegendsControl：オートメーションコマンドを送信する
• RaidShadowLegendsStatus：現在のゲームステータスを取得する
• RaidShadowLegendsSetGoal：オートメーションの目標を設定する

MQTT トピック

サーバーは次の MQTT トピックをパブリッシュおよびサブスクライブします。

• commands/raid：ゲームの一般的なコマンド
• commands/raid/goals：目標の設定
• status/raid：ゲームからのステータス更新

Tasker との連携

Tasker プロジェクトは次のように設定してください。

1. MQTT トピックをサブスクライブする
2. コマンドを解析して実行する
3. MQTT ブローカーにステータス更新をパブリッシュする

利用可能なコマンド

• raid_start：Raid Shadow Legends アプリを起動する
• clan_boss：クランボスへ移動して戦闘する
• raid_auto_toggle：オートバトルモードを切り替える
• raid_end：現在の戦闘を終了する
• raid_lock_toggle：画面ロックを切り替える

トラブルシューティング

• MQTT 接続の問題：MQTT ブローカーが稼働していて、アクセス可能であることを確認してください
• Tasker が応答しない：Tasker プロジェクトが正しく設定されていることを確認してください
• コマンドが動作しない：コマンドの形式とパラメーターを確認してください

TODO

• API アクセスに認証を追加する
• より詳細なステータスレポートを実装する
• 監視用の Web ダッシュボードを作成する
• より複雑なオートメーションワークフローのサポートを追加する

ライセンス

MIT

貢献

貢献を歓迎します！お気軽に Pull Request を送信してください。