Raid Shadow Legends But Its MCP

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仪表板
• 添加对更复杂的自动化工作流的支持

许可证

麻省理工学院

贡献

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