maa-ai avatar

MaaMCP Server

maa-ai/maamcp

Maamcp is an MCP server that exposes MaaFramework's automation capabilities to AI assistants, enabling control of Android devices via ADB and Windows desktop applications through standardized MCP interfaces. The server provides tools for device discovery and connection, screen capture and OCR text recognition, device control operations (clicking, swiping, text input, keyboard shortcuts), and pipeline-based automation with both serial and background streaming modes for managing multiple devices simultaneously. It solves the problem of integrating powerful device automation into AI assistant workflows without requiring direct framework access.

GitHub stars
350
tools
21
last updated
Jan 8, 2026

Tools

21 tools

Public tool metadata for what this MCP can expose to an agent.

find_adb_device_list扫描可用的 ADB 设备

扫描可用的 ADB 设备

No parameter schema in public metadata yet.

find_window_list扫描可用的 Windows 窗口

扫描可用的 Windows 窗口

No parameter schema in public metadata yet.

connect_adb_device连接到 Android 设备

连接到 Android 设备

No parameter schema in public metadata yet.

connect_window连接到 Windows 窗口

连接到 Windows 窗口

No parameter schema in public metadata yet.

ocr光学字符识别(高效,推荐优先使用)

光学字符识别(高效,推荐优先使用)

No parameter schema in public metadata yet.

screencap屏幕截图(按需使用,token 开销大)

屏幕截图(按需使用,token 开销大)

No parameter schema in public metadata yet.

click点击指定坐标(支持多触点/鼠标按键选择、长按)

点击指定坐标(支持多触点/鼠标按键选择、长按)

No parameter schema in public metadata yet.

double_click双击指定坐标

双击指定坐标

No parameter schema in public metadata yet.

swipe滑动手势(Android 设备滚动/翻页优先使用)

滑动手势(Android 设备滚动/翻页优先使用)

No parameter schema in public metadata yet.

input_text输入文本

输入文本

No parameter schema in public metadata yet.

click_key按键操作(支持长按)

按键操作(支持长按)

No parameter schema in public metadata yet.

keyboard_shortcut键盘快捷键

键盘快捷键

No parameter schema in public metadata yet.

scroll鼠标滚轮(仅 Windows)

鼠标滚轮(仅 Windows)

No parameter schema in public metadata yet.

start_pipeline启动后台监控流水线,持续截图并缓存图片路径

启动后台监控流水线,持续截图并缓存图片路径

No parameter schema in public metadata yet.

stop_pipeline停止流水线

停止流水线

No parameter schema in public metadata yet.

get_new_messages获取流水线缓存的新截图路径

获取流水线缓存的新截图路径

No parameter schema in public metadata yet.

get_pipeline_status获取流水线运行状态

获取流水线运行状态

No parameter schema in public metadata yet.

get_pipeline_protocol获取 Pipeline 协议文档

获取 Pipeline 协议文档

No parameter schema in public metadata yet.

save_pipeline保存 Pipeline JSON 到文件(支持新建和更新)

保存 Pipeline JSON 到文件(支持新建和更新)

No parameter schema in public metadata yet.

load_pipeline读取已有的 Pipeline 文件

读取已有的 Pipeline 文件

No parameter schema in public metadata yet.

run_pipeline运行 Pipeline 并返回执行结果

运行 Pipeline 并返回执行结果

No parameter schema in public metadata yet.

Sponsors

Readme

LOGO

MaaMCP

license activity stars
MaaFramework PyPI

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

English | 中文


简介

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


View the full README on GitHub

Details

Repository
github.com/maa-ai/maamcp
Categories
Automation & Workflows, Mobile Development

Related Automation & Workflows MCP servers

View all
1ruvnet avatarFlow Nexusruvnet/flow-nexusCloud-powered AI platform with multi-agent swarms, sandboxes, and workflow automation93stars
2expertvagabond avatarRaycastexpertvagabond/raycast-mcp-serverRaycast workflow automation MCP server with 9 tools3stars
3elasticflowapp avatarElasticflowelasticflowapp/elasticflow-mcpAI-native team workspace — tables, documents, workflow automation, live dashboards & analytics2stars
4ctrlabs avatarCTRLctrlabs/ctrl-mcpVisual DeFi workflow automation on Base + Ethereum mainnet.1stars
5sebastianall1977 avatarSebastianall1977 Gmail Mcpsebastianall1977/gmail-mcpManage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…0stars
6pingfyr avatarPingfyrpingfyr/mcpSchedule reminders for AI agents via email, webhook, Slack, Discord, Telegram, or Google Calendar.0stars