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 代理
• Android 设备上已安装 Tasker，并包含 Raid 自动化项目
• 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：前往并挑战 Clan Boss
• raid_auto_toggle：切换自动战斗模式
• raid_end：结束当前战斗
• raid_lock_toggle：切换屏幕锁定

故障排除

• MQTT 连接问题：确保 MQTT 代理正在运行且可访问
• Tasker 无响应：检查 Tasker 项目是否配置正确
• 命令无效：验证命令格式和参数

待办事项

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

许可证

MIT

参与贡献

欢迎贡献！请随时提交 Pull Request。