AWMS
Provides autonomous Android device management through ADB, enabling AI agents to inspect and control the UI, perform touch gestures, manage apps and files, record logcat, inspect network connections, adjust settings, read notifications/OTPs, and execute shell commands on a connected Android device.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
AWMS by LogicSpine — Android Web Management Service (v0.1.1)
AWMS is an autonomous Android device management engine and Model Context Protocol (MCP) server running on static port 7171, created by LogicSpine.
It provides:
Interactive Web Dashboard (
http://127.0.0.1:7171): Hardware-accelerated H.264 screen mirroring (30–60 FPS), touch/drag control, quality presets, 1-click wireless USB-to-Wi-Fi magic switch, APK installer, criss-cross file explorer, app manager, and terminal console.Strict URL-based MCP Server (
http://127.0.0.1:7171/sse): Comprehensive autonomous control tools for AI assistants (Antigravity, Cursor, Claude Desktop, Cline) with semantic UI tree navigation, live background logcat recording, app cache/data clearing, network socket inspection, compound action-inspect tools, and time-synchronized execution.Portable Standalone Executable (
awms.0.1.1.exe): A single zero-dependency Windows executable with built-in ADB engine that runs portably on any Windows PC without requiring Node.js or Android SDK installation.
⚡ Quick Start
Option A: Portable Windows Executable
Double-click awms.0.1.1.exe in the application root directory. It runs out of the box with portable ADB included.
Option B: Batch / Node.js
Double-click awms.bat in this folder, or run:
npm startStarts the service on static port
7171.Opens the Web Dashboard directly in your default browser.
Exposes the MCP SSE endpoint at
http://127.0.0.1:7171/sse.
Related MCP server: artemis
🤖 AI / MCP Setup (Strict URL-Based)
Paste this configuration directly into your AI assistant settings (Claude Desktop, Cursor, Antigravity, Cline):
{
"mcpServers": {
"awms": {
"url": "http://127.0.0.1:7171/sse"
}
}
}No local file paths or command args required. Simply connect via the HTTP/SSE URL.
🧠 Semantic UI Inspection (Fast Navigation Without Screenshots)
The Golden Rule for AI Agents: AI agents do NOT need to take screenshots to navigate apps or tap buttons.
Call
inspect_screen: Returns the active app package, resolution, and a clean list of all interactive buttons, inputs, switches, and sliders with their exact center coordinates[x, y]and pixelbounds.Call
tap_element({ text: "Login" })ortap(x, y): Hits the exact center with 100% mathematical precision.take_screenshotis reserved strictly for visual verification (e.g., verifying UI layout responsiveness across screen sizes, checking colors/styling, viewing photos, or canvas games).
🛠️ Complete MCP Tool Catalog (53 Tools)
1. Screen Vision & Semantic UI Inspection
Tool Name | Parameters | Description |
| (none) | Primary AI tool: Returns active app, resolution, and all interactive buttons, inputs, and widgets with exact center coordinates |
|
| Taps a button or widget directly by visible label or ID without needing coordinates. |
| (none) | Captures visual PNG image. Use only when visual styling, responsiveness, or canvas graphics require validation. |
| (none) | Dumps complete Android UI hierarchy XML ( |
| (none) | Returns parsed JSON list of all clickable buttons, inputs, and links on screen. |
2. Fast Compound Multi-Actions
Tool Name | Parameters | Description |
|
| Taps at (x, y), waits, and returns updated UI elements in a single tool call. |
|
| Swipes and returns updated UI elements. |
|
| Types text into focused input and returns updated UI elements. |
|
| Launches an app and returns its UI elements plus recent startup logs. |
|
| Opens URL in mobile browser and returns page UI elements. |
3. Touch, Gestures & Hardware Input
Tool Name | Parameters | Description |
|
| Tap coordinate on screen. |
|
| Double tap in rapid succession. |
|
| Long press (touch and hold). |
|
| Swipe gesture between two points. |
|
| Drag from source and drop at target. |
|
| Types text into the currently focused input field. |
|
| Simulates hardware key ( |
4. Deep Logcat & Live Log Recording
Tool Name | Parameters | Description |
|
| Reads logcat with filters for app package, tag, or minimum level ( |
|
| Starts background live logcat recorder into memory buffer before performing actions. |
| (none) | Stops background recording and returns all captured logcat output. |
|
| Reads current captured log buffer without stopping active recording. |
| (none) | Clears Android logcat buffer. |
5. App Management & Data Reset
Tool Name | Parameters | Description |
|
| Clears app cache and data ( |
|
| Installs an APK from host PC ( |
|
| Uninstalls an application. |
|
| Launches an app. |
|
| Force-stops an application. |
|
| Lists installed packages. |
|
| Searches installed apps by keyword. |
|
| Deep package info: version name/code, target SDK, permissions, install dates. |
6. Criss-Cross Storage & File Management
Tool Name | Parameters | Description |
|
| Reads text file content directly from Android storage into conversation. |
|
| Writes text content directly to a file on Android storage. |
|
| Copies file/directory from PC to phone. |
|
| Copies file/directory from phone to PC. |
|
| Deletes file or directory on phone ( |
|
| Lists directory contents with permissions, size, date. |
7. Network Inspection & Control
Tool Name | Parameters | Description |
|
| Lists active TCP/UDP sockets with local and remote IP:port and connection state. |
| (none) | Wi-Fi IP, SSID, airplane mode, and interface data counters from |
|
| Enables or disables network connections. |
8. System Settings & Clipboard
Tool Name | Parameters | Description |
|
| Reads Android system setting. |
|
| Modifies Android system setting. |
| (none) | Reads text from Android clipboard. |
|
| Sets text into Android clipboard. |
10. Agent Superpowers & System Health
Tool Name | Parameters | Description |
|
| Wakes the screen, dismisses the lockscreen swipe gesture, and inputs PIN digits if provided. |
| (none) | Comprehensive real-time device health snapshot: battery %, temperature, screen lock/orientation, audio/ringer, Wi-Fi IP, foreground app, and disk storage. |
|
| Reads active system and app notifications (titles and message bodies). |
| (none) | Scans incoming notifications for 4–8 digit verification/2FA codes and extracts the OTP. |
|
| Automatically detects and accepts or dismisses runtime permission prompts ("Allow", "While using the app", "OK", "Not now"). |
|
| Taps SeekBars or volume/brightness sliders at exact percentages (0–100%). |
|
| Multi-touch gesture ( |
|
| Real-time CPU % utilization, RAM breakdown (Total PSS, Native Heap, Dalvik Heap in MB), and rendering metrics (total frames, janky frames, jank %). |
11. ⏱️ Time-Synchronized Execution & Animation Capture
Tool Name | Parameters | Description |
| (none) | Returns the baseline server epoch timestamp in milliseconds ( |
| All 37 action tools | Optional epoch millisecond parameter. Use to schedule actions with sub-millisecond precision or emit action + screenshot in a single turn (e.g. action at |
12. Device Discovery & Shell
Tool Name | Parameters | Description |
| (none) | Lists connected devices (USB and Wireless). |
|
| Selects target device for multi-device setups. |
|
| Connects to Android over Wi-Fi. |
|
| 1-click magic switch from USB to Wireless ADB. |
|
| Opens URL in mobile browser. |
|
| Executes arbitrary ADB shell command with root/shell privileges. |
| (none) | Complete hardware specs, battery %, density, IP. |
📂 Project Structure
d:/LogicSpine/Awms/
├── awms.bat # One-click Windows starter (Dashboard + MCP)
├── awms-mcp.bat # Background MCP server daemon (Port 7171)
├── AI_INSTRUCTIONS.md # Instructions and protocol guide for AI assistants
├── package.json # TypeScript project configuration
├── src/
│ ├── adb.ts # High-performance ADB engine & UI tree parser
│ ├── dashboard-html.ts # Embedded dark-mode web dashboard
│ ├── mcp-server.ts # 53 MCP tools + AI prompts
│ ├── web-server.ts # HTTP, WebSocket & SSE Server (Port 7171)
│ └── index.ts # CLI entry point & URL banner
└── dist/ # Compiled JavaScript⚖️ Creator Attribution & License
Developed by LogicSpine.
This software is free to use, modify, and distribute.
Attribution Requirement: You must retain creator credit to LogicSpine in all copies, forks, distributions, and derivative works. See the LICENSE file for full terms.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Give your AI agent a real cloud Android phone: push APKs, drive it, get screenshots and logs.
Cloud Android phones for AI agents: create a phone, read the screen, tap, type, install APKs, park.
Let AI agents control Android and iOS devices on Mobilerun Cloud: screen, input, apps, workflows.
Drive real devices from your AI Coding tool. Embed a client SDK (Unity, Godot, Flutter, iOS/macOS, Android, React Native, Web) in your app, then capture screenshots, traverse the UI tree, inject taps and key events, and run automated test tasks on the physical device over a secure relay.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to observe, reason about, and control connected Android devices via ADB, providing tools for screenshots, UI hierarchy parsing, semantic element clicking, gestures, text input, and app lifecycle management.13MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants and IDEs to drive real Android devices and emulators for cross-app UI automation, testing, and diagnostics, including collecting Logcat output and screenshots.Apache 2.0
- AlicenseBqualityBmaintenanceEnables AI agents to automate Android and iOS devices, including emulators and physical devices, by capturing screenshots, reading UI accessibility trees, performing touch and text input, and managing app lifecycle and logs.184MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to operate a real Android phone through its accessibility service, exposing screen trees with stable refs, taps, typing, gestures, notifications, apps, and other device controls.5MIT