Serveur MCP Ramus Android
Commit 7 nov. 2026Fournit des émulateurs Android éphémères dans le cloud permettant aux agents IA d'exécuter des APK, d'interagir avec les éléments de l'interface utilisateur, de prendre des captures d'écran et de lire les journaux système.
Aussi connu sous ramus-dev/android-use, android-use
- Étoiles
- 4
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.2.0
- Dernier commit
- 7 nov. 2026
- Licence
- MIT
Qu'est-ce que Ramus Android MCP ?
Ramus Android est un serveur MCP. Fournit des émulateurs Android éphémères dans le cloud permettant aux agents IA d'exécuter des APK, d'interagir avec les éléments de l'interface utilisateur, de prendre des captures d'écran et de lire les journaux système.
Résumé généré à partir du README du projet
À propos du MCP server Ramus Android
Ramus Android propose des émulateurs Android éphémères basés sur le cloud, conçus spécifiquement pour les agents de codage IA. Il permet aux agents d'interagir avec des environnements mobiles en exécutant des APK et en effectuant des actions via une série d'outils spécialisés. Les utilisateurs peuvent se connecter via un MCP server distant en utilisant une connexion streamable HTTP, ce qui nécessite une clé API Ramus pour l'authentification. Le système est compatible avec divers clients, notamment Claude Desktop, Cursor, Windsurf et Gemini CLI.
Les développeurs utilisent ce serveur pour implémenter une boucle d'observation, d'action et de vérification. Le serveur expose des outils préfixés par android_ qui permettent à un agent de démarrer des sessions, de capturer l'arborescence de l'interface utilisateur (UI tree), de cliquer (tap), de taper du texte, d'appuyer sur des touches, de prendre des captures d'écran et de lire les journaux système. Tandis que le MCP server distant gère l'exécution des outils, le CLI associé est nécessaire pour l'upload local d'APK et la gestion du cycle de développement. Les émulateurs utilisent des images Google stock sur la flotte Ramus et diffusent l'interface via WebRTC.
Ce que vous pouvez faire avec
- 1Tests d'interface utilisateur automatisésUn agent IA peut interagir avec les éléments mobiles pour vérifier le comportement d'une application.
- 2Contrôle d'émulateur à distanceUn agent peut effectuer des saisies de type manuel, comme taper du texte ou cliquer sur un appareil dans le cloud.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Ramus Android MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Ramus Android MCP dans Claude Code
$ claude mcp add --transport http android-use https://api.ramus.dev/api/mcpInstaller Ramus Android MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}Installer Ramus Android MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"android-use": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}Installer Ramus Android MCP dans VS Code CLI
$ code --add-mcp '{"name":"android-use","type":"http","url":"https://api.ramus.dev/api/mcp"}'Installer Ramus Android MCP dans Codex
$ codex mcp add android-use --url https://api.ramus.dev/api/mcpInstaller Ramus Android MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.android-use] url = "https://api.ramus.dev/api/mcp"
Installer Ramus Android MCP dans Gemini CLI
$ gemini mcp add -s user --transport http android-use https://api.ramus.dev/api/mcpInstaller Ramus Android MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp",
"type": "http"
}
}
}Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleramus-dev/android-use is public and reachablegithub.com/ramus-dev/android-use ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-07github.com/ramus-dev/android-use ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPHTTPS endpoint answered 401 (sign-in required)Réussi
README
Voir sur 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.
Questions sur Ramus Android MCP
Comment ajouter Ramus Android MCP à Claude Code ?
Exécutez claude mcp add --transport http android-use https://api.ramus.dev/api/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Ramus Android MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Comment puis-je utiliser Ramus avec un client MCP comme Claude Desktop ou Cursor ?
Vous pouvez vous connecter en tant que serveur distant via l'endpoint streamable HTTP en fournissant votre clé API Ramus dans les headers.