MQScript MCP Server

一个基于 Model Context Protocol (MCP) 的 MQScript 移动自动化脚本语言服务器。

概述

本项目提供了一个全面的 MCP 服务器，支持 MQScript 移动自动化脚本语言的所有主要功能。通过这个服务器，AI 应用可以轻松生成和执行 MQScript 代码，用于移动设备自动化操作。

支持的功能

基础命令 (Basic Commands)

触摸命令: Tap, Touch, Swipe, KeyPress 等触摸操作
控制命令: Delay, For, If, While, Dim 等流程控制
颜色命令: GetPixelColor, FindColor, CmpColor 等颜色检测
其他命令: ShowMessage, TracePrint, RunApp, InputText 等

标准库函数 (Standard Library)

数学函数: Abs, Sin, Cos, Tan, Sqr, Rnd 等数学运算
字符串函数: Len, Left, Right, Mid, InStr, Replace, UCase, LCase 等字符串处理
类型转换函数: CInt, CStr, CBool, IsNumeric 等类型转换
数组函数: UBound, Split, Join 等数组操作

界面命令 (UI Commands)

UI 控件: NewLayout, AddTextView, AddEditText, AddButton, AddCheckBox 等控件创建
UI 属性: SetText, GetText, SetEnabled, SetVisible 等属性设置
悬浮窗: Create, Show, Hide, AddTextView, AddButton, SetText, OnClick 等悬浮窗操作

扩展命令 (Extension Commands)

元素操作: Element.GetText, Element.Click, Element.SetText, Element.Exists 等元素操作
设备操作: Device.GetInfo, Device.Vibrate, Device.SetBrightness, Device.SetVolume 等设备控制
电话操作: Phone.Call, Phone.SendSMS, Phone.GetCallState 等电话功能
系统操作: Sys.Exit, Sys.GetTime, Sys.Shell, Sys.GetEnv, Sys.SetEnv, Sys.Sleep 等系统功能

插件命令 (Plugin Commands)

JSON 操作: CJson.Parse, CJson.Stringify, CJson.Get, CJson.Set 等 JSON 处理
日期时间: DateTime.Now, DateTime.Format, DateTime.AddDays, DateTime.Compare 等日期时间操作
文件操作: File.Read, File.Write, File.Exists, File.Delete, File.Copy 等文件处理
图灵机器人: TURING.Chat, TURING.SetConfig 等 AI 对话功能

安装和使用

安装依赖

npm install

编译项目

npm run build

启动服务器

npm start

开发模式

npm run dev

MCP 客户端配置

在支持 MCP 的客户端中，添加以下配置：

{
  "mcpServers": {
    "mqscript": {
      "command": "node",
      "args": ["path/to/mcp-mqscript-server/build/index.js"],
      "env": {}
    }
  }
}

工具示例

基础触摸操作

// 点击屏幕坐标
mqscript_touch_tap({
  x: 100,
  y: 200,
  duration: 100
})

// 滑动操作
mqscript_touch_swipe({
  x1: 100,
  y1: 200,
  x2: 300,
  y2: 400,
  duration: 500
})

颜色检测

// 获取像素颜色
mqscript_color_getpixelcolor({
  x: 100,
  y: 200,
  resultVariable: "pixelColor"
})

// 查找颜色
mqscript_color_findcolor({
  x1: 0,
  y1: 0,
  x2: 720,
  y2: 1280,
  color: "0xFF0000",
  resultVariable: "redPixelPos"
})

UI 界面创建

// 创建布局
mqscript_ui_newlayout({
  orientation: "vertical"
})

// 添加按钮
mqscript_ui_addbutton({
  id: "btn1",
  text: "Click Me"
})

// 显示界面
mqscript_ui_show({
  title: "My App"
})

文件操作

// 读取文件
mqscript_file_read({
  filePath: "/sdcard/data.txt",
  encoding: "UTF-8",
  resultVariable: "fileContent"
})

// 写入文件
mqscript_file_write({
  filePath: "/sdcard/output.txt",
  content: "Hello, World!",
  encoding: "UTF-8",
  append: false
})

项目结构

mcp-mqscript-server/
├── src/
│   ├── tools/
│   │   ├── basic-commands.ts      # 基础命令
│   │   ├── standard-library.ts    # 标准库函数
│   │   ├── ui-commands.ts         # 界面命令
│   │   ├── extension-commands.ts  # 扩展命令
│   │   └── plugin-commands.ts     # 插件命令
│   └── index.ts                   # 主服务器文件
├── build/                         # 编译输出目录
├── package.json                   # 项目配置
├── tsconfig.json                  # TypeScript 配置
└── README.md                      # 项目文档

技术栈

TypeScript: 类型安全的 JavaScript 超集
Model Context Protocol SDK: MCP 协议的官方 SDK
Zod: 运行时类型验证库
Node.js: JavaScript 运行时环境

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目。

支持

如果你在使用过程中遇到问题，请提交 Issue 或联系维护者。