Raid Shadow Legends自动化控制服务器

通过Mission Control Protocol服务器控制Raid Shadow Legends的Tasker自动化任务,支持REST API和MQTT监控。

  • by MadnessEngineering
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 MadnessEngineering/RaidShadowLegendsButItsMCP

使用说明

Raid Shadow Legends MCP服务器

通过任务控制协议服务器控制Raid Shadow Legends Tasker自动化。

概述

该项目提供了一个MCP服务器,该服务器与Raid Shadow Legends的Tasker自动化集成。它允许您:

  • 通过MCP工具控制Raid Shadow Legends自动化
  • 通过REST API设置自动化目标
  • 通过MQTT监控游戏状态
  • 与Tasker项目交互

先决条件

  • Node.js 18+
  • MQTT代理在端口9900上运行
  • Tasker安装在带有Raid自动化项目的Android设备上
  • 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

要更改此设置,请修改 MQTT_SERVER_URL 两者都 src/index.ts 和 src/RaidShadowLegendsButItsMCP.ts.

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项目是否配置正确
  • 命令不起作用:验证命令格式和参数

全部

  • 为API访问添加身份验证
  • 实施更详细的状态报告
  • 创建用于监控的web仪表板
  • 添加对更复杂的自动化工作流的支持

许可证

麻省理工学院

贡献

欢迎投稿!请随时提交拉取请求。