maa-ai/maamcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

393 stars 44 forks Качество 82 Тренд 33AGPL-3.0

Repository Install

maa-ai/maamcp — это кандидат на сервер MCP, импортированный из https://github.com/maa-ai/maamcp.

Обзор

maa-ai/maamcp — это кандидат на сервер MCP, импортированный из https://github.com/maa-ai/maamcp.

Обзор (машинный перевод)

基于 MaaFramework 的 MCP 服务器为 AI 助手提供 Android 设备和 Windows 桌面自动化能力

Английский | 中文

简介

MaaMCP 是一个 MCP 服务器,将 MaaFramework 的强大自动化能力通过标准化的 MCP 接口暴露给 AI 助手(如 Claude)。通过本服务器,AI 助手可以:

🤖 Android 自动化 - 通过 ADB 连接并控制 Android 设备/模拟器
🖥️ Windows 自动化 - 控制 Windows 桌面应用程序
🎯 后台操作 - Windows 上的截图与控制均在后台运行,不占用鼠标键盘,您可以继续使用电脑做其他事情
🔗 多设备协同 - 同时控制多个设备/窗口，实现跨设备自动化
⚡ 双模式运行 - 串行模式（同步执行）和流水线模式（后台持续截图），适应不同场景需求
👁️ 智能识别 - 使用 OCR 识别屏幕文字内容
🎯 精准操作 - 执行点击、滑动、文本输入、按键等操作
📸 屏幕截图 - 获取实时屏幕截图进行视觉分析

Разговоры дешевы, 请看: ** 🎞️ Bilibili 视频演示**

功能特性

🔍 设备发现与连接

find_adb_device_list - 扫描可用的 ADB 设备
find_window_list - 扫描可用的 Windows 窗口
connect_adb_device - 连接到 Android 设备
connect_window - 连接到 Windows 窗口

👀 屏幕识别

ocr - 光学字符识别（高效，推荐优先使用）
screencap - 屏幕截图(按需使用,token 开销大)

截图与坐标约定

Win32 和 ADB 连接默认使用 target_short_side=720,保持画面比例。 OCR 的 region、返回框、点击、滑动和 Pipeline 均使用该控制器的完整截图坐标,不一定是设备物理坐标。 screencap 默认 resolution=None,不再额外缩放,整图坐标可直接用于操作。

连接时可传 target_short_side=1080 等正整数,或传 None 使用原尺寸。该选项会改变整个控制器的坐标基准,模板和 Pipeline ROI 必须使用匹配的尺度;现有 720p 资源应保留默认连接设置。依赖旧版 Win32 1080p 坐标的调用方可显式选择 1080。

screencap 默认仍返回路径字符串。

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

简介

MaaMCP 是一个 MCP 服务器，将 MaaFramework 的强大自动化能力通过标准化的 MCP 接口暴露给 AI 助手（如 Claude）。通过本服务器，AI 助手可以：

🤖 Android 自动化 - 通过 ADB 连接并控制 Android 设备/模拟器
🖥️ Windows 自动化 - 控制 Windows 桌面应用程序
- 🎯 后台操作 - Windows 上的截图与控制均在后台运行，不占用鼠标键盘，您可以继续使用电脑做其他事情
🔗 多设备协同 - 同时控制多个设备/窗口，实现跨设备自动化
⚡ 双模式运行 - 串行模式（同步执行）和流水线模式（后台持续截图），适应不同场景需求
👁️ 智能识别 - 使用 OCR 识别屏幕文字内容
🎯 精准操作 - 执行点击、滑动、文本输入、按键等操作
📸 屏幕截图 - 获取实时屏幕截图进行视觉分析

Talk is cheap, 请看: 🎞️ Bilibili 视频演示

功能特性

🔍 设备发现与连接

find_adb_device_list - 扫描可用的 ADB 设备
find_window_list - 扫描可用的 Windows 窗口
connect_adb_device - 连接到 Android 设备
connect_window - 连接到 Windows 窗口

👀 屏幕识别

ocr - 光学字符识别（高效，推荐优先使用）
screencap - 屏幕截图（按需使用，token 开销大）

截图与坐标约定

Win32 和 ADB 连接默认使用 target_short_side=720，保持画面比例。OCR 的 region、返回框、点击、滑动和 Pipeline 均使用该控制器的完整截图坐标，不一定是设备物理坐标。 screencap 默认 resolution=None，不再额外缩放，整图坐标可直接用于操作。

连接时可传 target_short_side=1080 等正整数，或传 None 使用原尺寸。该选项会改变整个控制器的坐标基准，模板和 Pipeline ROI 必须使用匹配的尺度；现有 720p 资源应保留默认连接设置。依赖旧版 Win32 1080p 坐标的调用方可显式选择 1080。

screencap 默认仍返回路径字符串。裁图或显式设置 resolution 后需要定位操作时，传入 include_metadata=True，返回以下信息：

字段	含义
`path`	图像绝对路径，也可传给 `save_captured_image`
`controller_id` / `coordinate_system`	所属控制器及坐标空间（`controller`）
`coordinate_size`	控制器完整截图 `[宽, 高]`
`image_size`	保存图像 `[宽, 高]`
`image_to_controller.scale`	图像到控制器的 `[sx, sy]` 比例
`image_to_controller.offset`	实际裁剪原点在控制器空间中的 `[ox, oy]`

图中点 (u, v) 应换算为 (round(u*sx+ox), round(v*sy+oy)) 再用于点击。变换包含实际缩放尺寸、取整和裁剪边界修正，只对应本次截图；窗口大小或布局变化后应重新截图。显式 resolution 只影响保存图像，不改变控制器坐标，也不能恢复之前下采样丢失的细节。

🎮 设备控制

click - 点击指定坐标（支持多触点/鼠标按键选择、长按）
- Windows 上支持指定鼠标按键：左键、右键、中键
double_click - 双击指定坐标
swipe - 滑动手势（Android 设备滚动/翻页优先使用）
input_text - 输入文本
click_key - 按键操作（支持长按）
- Android 上可模拟系统按键：返回键(4)、Home键(3)、菜单键(82)、音量键等
- Windows 上支持虚拟按键码：回车(13)、ESC(27)、方向键等
keyboard_shortcut - 键盘快捷键
- 支持组合键：Ctrl+C、Ctrl+V、Alt+Tab 等
scroll - 鼠标滚轮（仅 Windows）

⚡ 流水线模式（多线程后台监控）

Открыть полный README на GitHub

Установка

uvx maa-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "MaaMCP": {
      "command": "maa-mcp"
    }
  }
}