MCP server de Ramus Android
Commit 7 nov 2026Proporciona emuladores de Android desechables en la nube que permiten a los agentes de IA ejecutar APKs, interactuar con elementos de la interfaz de usuario, tomar capturas de pantalla y leer registros del sistema.
También conocido como ramus-dev/android-use, android-use
- Stars
- 4
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.2.0
- Último commit
- 7 nov 2026
- Licencia
- MIT
¿Qué es Ramus Android MCP?
Ramus Android es un MCP server. Proporciona emuladores de Android desechables en la nube que permiten a los agentes de IA ejecutar APKs, interactuar con elementos de la interfaz de usuario, tomar capturas de pantalla y leer registros del sistema.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Ramus Android
Ramus Android ofrece emuladores de Android desechables basados en la nube, diseñados específicamente para agentes de codificación con IA. Permite a los agentes interactuar con entornos móviles ejecutando APKs y realizando acciones a través de una serie de herramientas especializadas. Los usuarios pueden conectarse mediante un MCP server remoto usando una conexión streamable HTTP, la cual requiere una clave de API de Ramus para la autenticación. El sistema es compatible con varios clientes, incluyendo Claude Desktop, Cursor, Windsurf y Gemini CLI.
Los desarrolladores utilizan este servidor para implementar un bucle de observar, actuar y verificar. El servidor expone herramientas con el prefijo android_ que permiten a un agente iniciar sesiones, capturar el snapshot del árbol de la UI, hacer tap, escribir, presionar, tomar capturas de pantalla y leer registros del sistema. Mientras que el MCP server remoto gestiona la ejecución de las herramientas, es necesario el CLI complementario para la carga local de APKs y la gestión del bucle de desarrollo. Los emuladores ejecutan imágenes oficiales de Google en la flota de Ramus y transmiten la interfaz vía WebRTC.
Qué puedes hacer con él
- 1Pruebas de UI automatizadasUn agente de IA puede interactuar con elementos móviles para verificar el comportamiento de una aplicación.
- 2Control remoto de emuladoresUn agente puede realizar entradas de estilo manual, como escribir o hacer tap en un dispositivo en la nube.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Ramus Android MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Ramus Android MCP en Claude Code
$ claude mcp add --transport http android-use https://api.ramus.dev/api/mcpInstalar Ramus Android MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}Instalar Ramus Android MCP en VS Code
.vscode/mcp.json
{
"servers": {
"android-use": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}Instalar Ramus Android MCP en VS Code CLI
$ code --add-mcp '{"name":"android-use","type":"http","url":"https://api.ramus.dev/api/mcp"}'Instalar Ramus Android MCP en Codex
$ codex mcp add android-use --url https://api.ramus.dev/api/mcpInstalar Ramus Android MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.android-use] url = "https://api.ramus.dev/api/mcp"
Instalar Ramus Android MCP en Gemini CLI
$ gemini mcp add -s user --transport http android-use https://api.ramus.dev/api/mcpInstalar Ramus Android MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp",
"type": "http"
}
}
}Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleramus-dev/android-use is public and reachablegithub.com/ramus-dev/android-use ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-07github.com/ramus-dev/android-use ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPHTTPS endpoint answered 401 (sign-in required)Aprobado
README
Ver en GitHubRamus android-use
Android-use for coding agents, powered by Ramus. Give Claude Code, Codex, Cursor, Gemini CLI or any agent with a shell a disposable cloud Android emulator it can see, tap, type on, screenshot and read logs from, then watch or take over in your browser.
This plugin connects to the Ramus hosted service. It needs a Ramus account (free during alpha) or a 60-minute CLI trial.
Install
Claude Code, as a plugin (the android-use skill plus the Ramus MCP server; you are asked for an optional API key):
/plugin marketplace add ramus-dev/android-use
/plugin install ramus@ramus
Cursor, Codex, GitHub Copilot, Kiro and other Agent Plugins clients: install this repository as a plugin (plugin.json at the root).
Any agent that supports skills, via the skills CLI:
npx skills add ramus-dev/android-use
Claude Code, by hand: copy skills/android-use/SKILL.md to .claude/skills/android-use/SKILL.md.
Gemini CLI, as an extension (bundles the skill and the Ramus MCP server):
gemini extensions install https://github.com/ramus-dev/android-use
Any MCP client (Cline, Claude Desktop, Cursor, Windsurf, VS Code), as a remote server. Streamable HTTP, no local process:
{
"mcpServers": {
"ramus": {
"url": "https://api.ramus.dev/api/mcp",
"headers": { "Authorization": "Bearer <RAMUS_API_KEY>" }
}
}
}
Create the key at https://ramus.dev/settings. The server exposes android_* tools (start a session from a demo app or pull request, snapshot the UI tree, tap, type, press, wait, screenshot, logs, share); list them with tools/list. Local APK upload and the dev loop need the CLI below.
The trial needs no account:
npx ramus-cli trial
npx ramus-cli session start --apk app-debug.apk --wait
ChatGPT and Codex (OpenAI plugin)
The same repository is the OpenAI plugin package: plugin.json carries the
directory listing under extensions.com.openai, mcp.json points at the
remote MCP server (people connect by signing in to Ramus; no API key), and
the skills declare where they run in skills/*/agents/openai.yaml.
The OpenAI package ships only android-mcp (MCP tools, ChatGPT and Codex):
android-use drives the CLI through the shell, which OpenAI's skill scan
flags, so the OpenAI packaging workflow leaves it out.
Maintainers can build the upload for the OpenAI plugin portal ("With MCP" path) using the manual Package OpenAI plugin workflow:
- Open Actions → Package OpenAI plugin → Run workflow and choose the branch or tag to package.
- After it succeeds, download the ramus-openai-upload artifact from the run and unpack it.
- Upload the enclosed
ramus-openai-plugin.zipto the OpenAI plugin portal.
The workflow checks the listing against OpenAI's limits and packages only
the OpenAI manifest, MCP configuration, license, logo and android-mcp skill.
It runs only in GitHub Actions when a maintainer requests an upload; the
installed plugin does not run the packaging code.
How it works
The device is a real Android emulator running stock Google images on the Ramus fleet, streamed over WebRTC. The skill teaches the agent the observe, act, verify loop: read a snapshot of the UI tree, act on a referenced element, then check the result before moving on.
Links
-
Agent reference: https://ramus.dev/agents.md
-
MCP endpoint (Streamable HTTP, API key): https://api.ramus.dev/api/mcp
-
CLI on npm: https://www.npmjs.com/package/ramus-cli
-
Privacy policy: https://ramus.dev/privacy
-
Terms: https://ramus.dev/terms
-
Acceptable use: https://ramus.dev/acceptable-use
-
Support: hello@ramus.dev · Security: security@ramus.dev
Android only. Free during alpha. For testing apps you build or are authorized to test.
SKILL.md is generated from the Ramus product contracts; the canonical copy is served at https://ramus.dev/skill.md.
Preguntas sobre Ramus Android MCP
¿Cómo agrego Ramus Android MCP a Claude Code?
Ejecuta claude mcp add --transport http android-use https://api.ramus.dev/api/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Ramus Android MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo puedo usar Ramus con un cliente MCP como Claude Desktop o Cursor?
Puedes conectarte como un servidor remoto utilizando el endpoint de streamable HTTP proporcionando tu clave de API de Ramus en los headers.