What is Maccontroller

macController is a Node.js/TypeScript service designed for monitoring and remote control of Mac systems, tailored for MCP.

Use cases

Use cases for macController include remote troubleshooting of Mac systems, automated testing of applications, and monitoring system performance in real-time.

How to use

To use macController, clone the repository, switch to the project directory, set the Node version using nvm, install dependencies with npm, and then compile and run the service.

Key features

Key features include system monitoring (CPU, memory, disk usage), network status detection, process management, remote control capabilities (screenshot capture, keyboard and mouse simulation), and a RESTful API with WebSocket support.

Where to use

macController can be used in various fields such as IT management, remote support, and automation tasks where Mac system monitoring and control are required.

macController 🖥️

一个用于Mac系统监控和远程控制的Node.js/TypeScript服务。

✨ 功能特性

系统监控

• CPU/内存/磁盘使用率监控
• 网络状态检测
• 进程管理

远程控制

• 屏幕截图捕获
• 键盘鼠标模拟
• 应用程序控制

API服务

• RESTful API接口
• WebSocket实时通信
• 类型安全的TypeScript实现

📡 API文档

🖱️ 鼠标控制

POST /mouse/move
移动鼠标到指定坐标
请求参数:

{
  "x": 100,
  "y": 200
}

⌨️ 键盘控制

POST /keyboard/type
模拟键盘输入文本
请求参数:

{
  "text": "Hello World"
}

🖥️ 屏幕信息

GET /screen/info
获取屏幕分辨率、DPI等信息
响应示例:

{
  "screenCount": 1,
  "primaryScreen": {
    "width": 2560,
    "height": 1440,
    "dpi": 96,
    "scaling": {
      "scaleX": 1,
      "scaleY": 1
    }
  }
}

🔍 屏幕分析

POST /screen/analyze
捕获屏幕并发送AI分析
请求参数:

{
  "prompt": "请描述屏幕内容并定位搜索框位置"
}

安装要求

• Node.js 18.20.8 (推荐使用nvm管理版本)
• npm 8+
• TypeScript 4+
• 环境变量配置:

  # 服务器端口(默认15800)
  SERVER_PORT=15800
  
  # GLM API密钥
  GLM_API_KEY=your_api_key_here
  

🚀 快速开始

1. 克隆仓库
2. 切换到项目目录并设置Node版本：

   nvm use
   

3. 安装依赖：

   npm install
   

4. 创建.env文件并配置环境变量
5. 编译并运行：

   npm run build
   npm start
   

🔧 开发指南

• 使用npm run dev启动开发服务器
• 代码位于src/目录
• 类型定义在src/types/

📜 许可证

MIT © czhmisaka