# 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 对话功能

## 安装和使用

### 安装依赖
```bash
npm install
```

### 编译项目
```bash
npm run build
```

### 启动服务器
```bash
npm start
```

### 开发模式
```bash
npm run dev
```

## MCP 客户端配置

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

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

## 工具示例

### 基础触摸操作
```javascript
// 点击屏幕坐标
mqscript_touch_tap({
  x: 100,
  y: 200,
  duration: 100
})

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

### 颜色检测
```javascript
// 获取像素颜色
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 界面创建
```javascript
// 创建布局
mqscript_ui_newlayout({
  orientation: "vertical"
})

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

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

### 文件操作
```javascript
// 读取文件
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 或联系维护者。