MCP server của MAS

MCP server Android cho Claude Code, Cursor, Codex và mọi MCP client

25 công cụ trao cho AI client của bạn đôi mắt và đôi tay trên Android: ảnh chụp màn hình nó nhìn được, OCR và so khớp ảnh mẫu, chạm, vuốt và gõ, chạy macro, và một agent dựng macro từ một câu. Điều khiển BlueStacks, LDPlayer, MuMu, MEmu hoặc bất kỳ giả lập tương thích adb nào trên Windows hay Mac, điện thoại cắm vào máy tính, hoặc thiết bị Android đám mây luôn bật, từ một endpoint từ xa.

Server lưu trữ với token lấy từ khóa MAS của bạn, rồi trình kết nối cục bộ miễn phí dưới dạng stdio server.

claude mcp add --transport http mas https://api.automationmacro.com/mcp --header "Authorization: Bearer $MAS_MCP_TOKEN"
claude mcp add mas-local -- python -m masagent mcp
Tải ứng dụng Làm quen với MAS Agent Tài liệu cài đặt

Đây là gì

MCP server Android của MAS làm gì

MCP là giao thức mà các AI client dùng để gọi công cụ bên ngoài. Server này biến một thiết bị Android thành những công cụ đó. Client của bạn xin ảnh chụp màn hình và nhận về một hình ảnh nó nhìn được; hỏi màn hình đang hiện gì và nhận về các dòng OCR kèm độ tin cậy và khung bao; gửi một ảnh mẫu và nhận về vị trí của nó; chạm, vuốt, gõ và bấm phím; mở và đóng ứng dụng. Đó là phần mà mọi MCP server Android đều làm, và nó hoạt động như nhau trên giả lập, điện thoại cắm vào máy hay thiết bị đám mây.

Server của MAS còn làm phần mà một server thiết bị không làm được. Nó đọc và chạy các macro trong thư viện của bạn, nó nhờ MAS Agent khám phá một ứng dụng và trả về một macro Python hoàn chỉnh, và nó cung cấp bản đồ agent đã học về ứng dụng đó, cộng với toàn bộ tài liệu tham chiếu SDK dưới dạng tài nguyên MCP để client của bạn viết code macro theo phong cách nhà. Điều đó khiến nó là MCP server cho tự động hóa Android ở tầng thiết bị, và là MCP server tự động hóa di động cho các tầng bên trên: macro, agent, bản đồ. Nó không phải plugin Android Studio và không phải trợ lý viết code. Nó điều khiển thiết bị.

Server lưu trữ

Đủ 25 công cụ, trên thiết bị đám mây của bạn

Một endpoint HTTP từ xa. Thuê một thiết bị đám mây, điều khiển nó, chạy macro phía máy chủ, dựng macro mới với agent, đọc bản đồ ứng dụng. Không cần cài gì, và máy tính của bạn có thể tắt.

Trình kết nối cục bộ, miễn phí

13 công cụ thiết bị và thị giác, trên máy của bạn

Một stdio server bạn tự chạy. Nó điều khiển bất cứ gì adb nhìn thấy: BlueStacks, LDPlayer, MuMu, MEmu trên Windows hoặc macOS, hoặc điện thoại đã bật gỡ lỗi USB. Màn hình, thao tác, OCR và so khớp ảnh mẫu. Không cần tài khoản.

Giả lập

Điều khiển giả lập Android: BlueStacks, LDPlayer, MuMu, MEmu trên Windows hoặc Mac

Trình kết nối cục bộ là MCP server giả lập Android cho chiếc giả lập đã có trên bàn bạn. Khởi chạy bằng python -m masagent mcp, trỏ nó vào một thiết bị bằng tham số hoặc biến MAS_DEVICE, hoặc để nó lấy thiết bị đầu tiên adb liệt kê. Nó chỉ cần adb trong PATH và không gì khác, và không bao giờ gửi dữ liệu về nhà. Đây là cấu hình MCP giả lập Android mà hầu hết mọi người đang tìm: một lệnh, adb, xong. Trang Connect trong ứng dụng MAS hướng dẫn bạn từng bước.

  • BlueStacks
  • LDPlayer
  • MuMu
  • MEmu
  • Windows
  • macOS

Game là trường hợp làm hỏng các server dựa trên cây accessibility: không có cây nào để đọc. Trình kết nối làm việc từ điểm ảnh, nên mô hình có thể chơi qua màn hình game như cách nó đi qua màn hình cài đặt.

Thiết bị đám mây

Thiết bị Android đám mây, không cần cài gì

Server lưu trữ kết nối với các thiết bị luôn bật mà MAS vận hành cho bạn. lease_device mở một phiên điều khiển và trả về lease id mà mọi công cụ thiết bị cần; đặt auto_start và nó sẽ khởi động thiết bị đang dừng trước. Phiên thuê được gia hạn ở mỗi lệnh gọi và hết hạn sau 10 phút không hoạt động, nên một client bị bỏ quên không thể giữ thiết bị mãi. run_macro thực thi trên thiết bị phía máy chủ và author_macro giao việc cho MAS Agent trên đó, cả hai đều khi máy tính của bạn đã tắt.

Công cụ thiết bị không tính phí theo lệnh gọi; chúng hoạt động trên các thiết bị đám mây tài khoản bạn sở hữu, $80/tháng mỗi thiết bị kèm hạn mức credit hằng tháng. Xem thiết bị đám mây.

Điện thoại của bạn

MCP server ADB Android cho chiếc điện thoại trên bàn bạn

Bật gỡ lỗi USB, cắm điện thoại vào, và trình kết nối cục bộ liệt kê nó bên cạnh giả lập của bạn. Mọi công cụ màn hình, thao tác và thị giác đều hoạt động trên đó: mô hình có thể điều khiển điện thoại Android qua MCP giống hệt cách nó điều khiển giả lập, từ client bạn đang dùng, không cài gì lên điện thoại.

Thị giác

Ảnh chụp màn hình mô hình nhìn được, OCR và so khớp ảnh mẫu

  • screenshot trả về màn hình dưới dạng nội dung hình ảnh, nên mô hình nhìn thẳng vào đó thay vì đoán từ một cây. Trình kết nối cục bộ thu nhỏ về 1280 px ở cạnh dài và báo hệ số tỷ lệ.
  • read_text chạy OCR trên màn hình hoặc một vùng và trả về từng dòng kèm độ tin cậy và khung bao, nên "chạm vào chữ Nhận" là một tọa độ, không phải một hy vọng.
  • find_image so khớp ảnh mẫu bạn gửi bằng OpenCV, với ngưỡng do bạn kiểm soát, và trả về điểm số cùng tâm để chạm.

Công cụ

Đủ 25 công cụ

Mọi công cụ theo tên, kèm tham số. Công cụ "cục bộ và lưu trữ" có ở cả hai bề mặt; phần còn lại cần thiết bị đám mây.

Device control

Pick a device and drive it: the same taps, swipes and keys a person would use.

  • list_devices cục bộ và lưu trữ
    List the devices your client can reach, with their state. On the hosted server that is your cloud devices; on the local connector, whatever adb can see.
  • lease_device (device_id, auto_start) lưu trữ
    Open a control session on one of your cloud devices and get the lease_id every device tool needs. Can boot a stopped device first. Leases expire after ten idle minutes and renew on every call.
  • release_device (lease_id) lưu trữ
    End the control session. The device keeps running.
  • tap (x, y) cục bộ và lưu trữ
    Tap the screen at device coordinates.
  • swipe (x1, y1, x2, y2, duration_ms) cục bộ và lưu trữ
    Swipe between two points for scrolling and drags, with a chosen duration.
  • type_text (text) cục bộ và lưu trữ
    Type text into the focused input field.
  • press_key (key) cục bộ và lưu trữ
    Press BACK, HOME, ENTER, TAB, DEL or any KEYCODE_ name.
  • open_app (package) cục bộ và lưu trữ
    Launch an app by package name.
  • close_app (package) cục bộ và lưu trữ
    Force-stop an app by package name.
  • current_app cục bộ và lưu trữ
    Report the package in the foreground.
  • screen_size cục bộ và lưu trữ
    Return the screen size in pixels, the coordinate space for tap and swipe.
  • wait (ms) cục bộ và lưu trữ
    Pause for animations and loading screens, up to ten seconds per call.

Vision

Let the model see the screen and locate things on it without guessing coordinates.

  • screenshot (lease_id) cục bộ và lưu trữ
    Capture the screen and return it as an image the model can look at.
  • read_text (region) cục bộ và lưu trữ
    OCR the whole screen or one region into text lines, each with a confidence and a bounding box.
  • find_image (template_base64, threshold) cục bộ và lưu trữ
    Locate a template image on screen with OpenCV matching and return the match score and tap coordinates.

Macros and runs

Your macro library, readable and runnable from the client. Runs execute server-side on a cloud device.

  • list_macros (page, page_size) lưu trữ
    List your saved macros with name, id and type, paged.
  • get_macro_code (macro_id, file) lưu trữ
    Read a macro's source: the entry script by default, plus the file listing, or any file you name.
  • run_macro (macro_id, device_id, args) lưu trữ
    Start a saved macro on a cloud device, server-side, with optional argument overrides. Returns a run_id.
  • get_run (run_id) lưu trữ
    The state of a run, from launching through running to finished or failed, with its message.
  • stop_run (run_id) lưu trữ
    Stop a running macro.

Agent authoring

Hand a goal to MAS Agent and get a finished macro back, from any client.

  • author_macro (prompt, device_id, model) lưu trữ
    Ask MAS Agent to build a new macro on a cloud device from a plain-language goal. Runs for several minutes and spends AI credits. Returns a session_id.
  • get_agent_session (session_id, after_seq) lưu trữ
    Progress of an authoring session: state, summary, the macro id once it exists, and the transcript events after your cursor, including any question the agent asked.
  • answer_agent_session (session_id, qid, answers) lưu trữ
    Answer the agent's pending question so it can continue.
  • stop_agent_session (session_id) lưu trữ
    Stop a session early. Work done so far is saved.

App maps

What the agent has learned about an app, readable by your client.

  • get_map (package, profile) lưu trữ
    The learned menu map of an app: its screens and the proven routes between them.

Tài nguyên

Tài liệu server công bố để client viết code macro mà không cần rời cuộc trò chuyện.

  • mas://docs/sdk-reference The full mas SDK reference, so an external agent can write macro code in house style.
  • mas://docs/house-library The house library of helpers the agent and the studio use.

Cài đặt

Thêm trong một phút

Server lưu trữ dùng OAuth client credentials: tạo một khóa trong ứng dụng ở mục API keys, chọn phạm vi cho nó, và đổi lấy access token có hiệu lực 1 giờ. Gửi token đó dưới dạng header bearer. Trình kết nối cục bộ không cần khóa. 

curl -s -X POST https://api.automationmacro.com/api/mcp/oauth/token -d grant_type=client_credentials -d client_secret=$MAS_API_KEY

Claude Code

Server lưu trữ với token ở trên, hoặc trình kết nối cục bộ dưới dạng lệnh stdio:

claude mcp add --transport http mas https://api.automationmacro.com/mcp --header "Authorization: Bearer $MAS_MCP_TOKEN"
claude mcp add mas-local -- python -m masagent mcp

Cursor

Trong .cursor/mcp.json, một mục HTTP từ xa kèm header:

{
  "mcpServers": {
    "mas": {
      "url": "https://api.automationmacro.com/mcp",
      "headers": { "Authorization": "Bearer <your token>" }
    }
  }
}

Codex CLI

Trong ~/.codex/config.toml, với token trong biến môi trường:

[mcp_servers.mas]
url = "https://api.automationmacro.com/mcp"
bearer_token_env_var = "MAS_MCP_TOKEN"

Hermes, OpenCode, Gemini CLI và các client khác

Bất kỳ client nào nhận một server HTTP từ xa có header, hoặc khởi chạy một lệnh stdio. Claude Desktop và connector của claude.ai yêu cầu đăng nhập tương tác, nên hãy dùng một cầu nối cục bộ thêm header.

{
  "mcpServers": {
    "mas": { "type": "http", "url": "https://api.automationmacro.com/mcp", "headers": { "Authorization": "Bearer <your token>" } },
    "mas-local": { "command": "python", "args": ["-m", "masagent", "mcp"] }
  }
}

Kiểm tra: yêu cầu client liệt kê thiết bị, rồi xin một ảnh chụp màn hình. Endpoint https://api.automationmacro.com/mcp, giao thức 2025-06-18, tài liệu khám phá ở /.well-known.

Agent, dưới dạng công cụ

author_macro: từ một lần AI khám phá đến macro Python hoàn chỉnh

Hầu hết MCP server Android dừng ở thiết bị. Server này trao cho bạn cả agent. author_macro nhận một mục tiêu bằng lời thường và một thiết bị đám mây rồi khởi động một phiên MAS Agent: khám phá ứng dụng, chụp ảnh mẫu và vùng chữ nó cần từ màn hình thật, biên dịch một macro Python xác định và kiểm chứng bằng cách chạy lại. get_agent_session trả về bản ghi kèm con trỏ và bất kỳ câu hỏi nào agent đặt ra; answer_agent_session trả lời câu hỏi đó. Macro hoàn chỉnh nằm trong thư viện của bạn với id trong phiên, sẵn sàng cho run_macro, và mọi lần chạy sau đó không tốn credit AI. Xem MAS Agent.

QA

Kiểm thử ứng dụng Android và quy trình QA

Trỏ client vào một bản build thử nghiệm trên giả lập hoặc thiết bị đám mây, điều khiển luồng bằng tap, type_text và press_key, và kiểm tra từng màn hình bằng read_text hoặc find_image. Đi qua luồng một lần với author_macro và nó trở thành một bài kiểm tra lặp lại được mà bạn có thể đặt lịch. Nó kiểm thử ứng dụng qua màn hình như cách người dùng làm; nó không phải framework unit test.

Bảo mật

Server từ xa, truyền tải HTTP, khóa có phạm vi, và một trình kết nối không bao giờ gửi dữ liệu về nhà

Server lưu trữ là JSON-RPC không trạng thái qua HTTPS trên một endpoint. Khóa được tạo trong ứng dụng, hiển thị một lần, có thể mang ngày hết hạn và thu hồi bằng một cú nhấp; token tạo từ khóa có hiệu lực 1 giờ. Mỗi khóa chỉ mang những phạm vi bạn cấp:

  • devices:control lease a cloud device, see its screen, tap, type and manage apps
  • macros:run list and read macros, start, check and stop runs
  • macros:author start, follow, answer and stop an agent authoring session
  • maps:read read the learned map of an app

Trình kết nối cục bộ không tự thực hiện kết nối mạng nào: nó nói chuyện với adb trên máy bạn và với client của bạn, không gì khác.

Câu hỏi thường gặp về MCP server Android

MCP server Android là gì?

MCP (Model Context Protocol) là cách các AI client như Claude Code, Cursor và Codex gọi công cụ bên ngoài. MCP server Android cung cấp một thiết bị Android dưới dạng công cụ: chụp màn hình, đọc chữ trên đó, chạm, vuốt, gõ, mở ứng dụng. Server của MAS cung cấp 25 công cụ, và thêm những gì một server thiết bị đơn thuần không làm được: chạy macro đã lưu, nhờ MAS Agent dựng macro, và đọc bản đồ nó đã học về một ứng dụng.

Làm sao kết nối Claude Code với giả lập Android?

Với giả lập của bạn, chạy trình kết nối cục bộ miễn phí (python -m masagent mcp) và thêm vào Claude Code dưới dạng stdio server; nó điều khiển mọi thiết bị adb nhìn thấy. Với thiết bị đám mây, tạo một khóa trong ứng dụng, đổi lấy token, và thêm server lưu trữ bằng claude mcp add --transport http cùng header bearer. Cả hai đoạn cấu hình đều có trên trang này.

Có hoạt động với BlueStacks, LDPlayer, MuMu, MEmu không?

Có. Trình kết nối cục bộ nói chuyện với bất cứ gì adb devices liệt kê, bao gồm BlueStacks, LDPlayer, MuMu, MEmu và các giả lập tương thích adb khác, trên Windows hoặc macOS. Không có gì trong đó gắn với một hãng giả lập cụ thể.

Cursor hoặc Codex có điều khiển được giả lập Android qua MCP không?

Có. Cursor nhận server lưu trữ dưới dạng mục HTTP từ xa trong mcp.json với header Authorization, và trình kết nối cục bộ dưới dạng lệnh stdio. Codex CLI nhận server lưu trữ bằng codex mcp add và token bearer từ biến môi trường. Cùng bộ công cụ xuất hiện ở mỗi client.

Những MCP client nào khác hoạt động được?

Bất kỳ client nào gọi được MCP server HTTP từ xa với header bearer, hoặc khởi chạy được stdio server: Claude Code, Cursor, Codex, Hermes, OpenCode, Gemini CLI và các client khác. Claude Desktop và connector tùy chỉnh của claude.ai yêu cầu luồng đăng nhập tương tác, nên với MAS chúng kết nối qua một cầu nối cục bộ thêm header.

Tôi có cần cài ADB hoặc Android Studio không?

Trình kết nối cục bộ dùng adb bên dưới, nên adb phải có trong PATH; không cần Android Studio. Server lưu trữ không cần cài gì cả: thiết bị đám mây được điều khiển phía máy chủ và client của bạn chỉ gọi công cụ.

Mô hình có thực sự nhìn thấy màn hình không?

Có. screenshot trả về màn hình dưới dạng hình ảnh mà mô hình nhìn thẳng vào. read_text chạy OCR và trả về từng dòng kèm độ tin cậy và khung bao, còn find_image so khớp ảnh mẫu bạn gửi và trả về điểm số cùng tọa độ chạm. Không cần cây accessibility, đó là lý do nó hoạt động với game.

Tôi có thể điều khiển điện thoại Android thật cắm vào máy tính không?

Có, qua trình kết nối cục bộ. Bật gỡ lỗi USB, cắm điện thoại vào, và nó xuất hiện trong list_devices như mọi giả lập. Các công cụ màn hình, thao tác và thị giác hoạt động giống hệt.

Đây là MCP server từ xa hay chạy cục bộ?

Cả hai. Server lưu trữ là một endpoint HTTP từ xa, https://api.automationmacro.com/mcp, với đủ 25 công cụ cho thiết bị đám mây của bạn. Trình kết nối cục bộ là stdio server miễn phí bạn chạy trên máy mình với 13 công cụ thiết bị và thị giác cho giả lập và điện thoại cắm vào máy. Chạy macro, dựng macro bằng agent và bản đồ ứng dụng chỉ có trên server lưu trữ.

Xác thực hoạt động thế nào?

OAuth client credentials. Bạn tạo một khóa trong ứng dụng và chọn phạm vi cho nó; client đổi khóa lấy access token một giờ tại https://api.automationmacro.com/api/mcp/oauth/token và gửi nó dưới dạng token bearer. Khóa có thể mang ngày hết hạn và có thể thu hồi bất cứ lúc nào. Tài liệu khám phá được công bố ở /.well-known.

author_macro trả về gì, và mất bao lâu?

Nó khởi động một phiên MAS Agent trên thiết bị đám mây và trả về session id ngay lập tức. Agent khám phá ứng dụng trong vài phút; get_agent_session truyền bản ghi kèm con trỏ và đưa ra bất kỳ câu hỏi nào nó đặt, bạn trả lời bằng answer_agent_session. Khi xong, macro id nằm trong phiên và macro nằm trong thư viện của bạn, sẵn sàng cho run_macro. Dựng macro tiêu credit AI; chạy macro hoàn chỉnh không tốn gì. Xem MAS Agent.

Có miễn phí không? Thiết bị đám mây giá bao nhiêu?

Trình kết nối cục bộ miễn phí. Server lưu trữ là một phần của tài khoản MAS; công cụ thiết bị của nó hoạt động trên các thiết bị đám mây bạn sở hữu, $80/tháng mỗi thiết bị kèm hạn mức credit hằng tháng, và không có phí theo lệnh gọi cho công cụ thiết bị. Chạy macro hoàn chỉnh không tốn credit; dựng macro bằng agent tiêu credit trong lúc làm việc. Xem bảng giá.

Có chạy được 24/7 trên thiết bị đám mây mà không cần bật máy tính không?

Có. lease_device mở một phiên điều khiển trên thiết bị đám mây và có thể khởi động thiết bị đang dừng; run_macro thực thi phía máy chủ. Máy tính của bạn không cần bật, và phiên thuê được gia hạn ở mỗi lệnh gọi rồi hết hạn sau 10 phút không hoạt động. Xem thiết bị đám mây.

Tôi có thể dùng nó để kiểm thử ứng dụng Android và QA không?

Có. Trỏ client vào một bản build thử nghiệm, điều khiển luồng bằng tap, type và press_key, kiểm tra từng màn hình bằng read_text hoặc find_image, và để author_macro biến luồng bạn đi qua một lần thành bài kiểm tra lặp lại được. Nó tự động hóa ứng dụng qua màn hình như cách người dùng làm; nó không phải framework unit test.

Tải ứng dụng Xem bảng giá Tài liệu cài đặt