Ramus Android MCP server
Commit 7. Nov. 2026Bietet disposable Cloud-Android-Emulatoren, mit denen AI Agents APKs ausführen, mit UI-Elementen interagieren, Screenshots erstellen und Systemlogs lesen können.
Auch bekannt als ramus-dev/android-use, android-use
- Stars
- 4
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.2.0
- Letzter Commit
- 7. Nov. 2026
- Lizenz
- MIT
Was ist Ramus Android MCP?
Ramus Android ist ein MCP server. Bietet disposable Cloud-Android-Emulatoren, mit denen AI Agents APKs ausführen, mit UI-Elementen interagieren, Screenshots erstellen und Systemlogs lesen können.
Zusammenfassung generiert aus dem README des Projekts
Über Ramus Android MCP server
Ramus Android bietet disposable, cloudbasierte Android-Emulatoren, die speziell für AI Coding Agents entwickelt wurden. Sie ermöglichen es Agents, mit mobilen Umgebungen zu interagieren, indem sie APKs ausführen und Aktionen über eine Reihe spezialisierter Tools durchführen. Nutzer können sich über einen Remote MCP Server mittels einer streamable HTTP Verbindung verbinden, die zur Authentifizierung einen Ramus API Key erfordert. Das System ist mit verschiedenen Clients kompatibel, darunter Claude Desktop, Cursor, Windsurf und Gemini CLI.
Entwickler nutzen diesen Server, um einen Observe-Act-Verify-Loop zu implementieren. Der Server stellt mit android_ präfixierte Tools bereit, die es einem Agent ermöglichen, Sessions zu starten, den UI-Tree zu snapshotten, zu tippen, zu schreiben, zu drücken, Screenshots zu machen und Systemlogs zu lesen. Während der Remote MCP Server die Tool-Ausführung übernimmt, ist das begleitende CLI für lokale APK-Uploads und die Verwaltung des Development-Loops notwendig. Die Emulatoren nutzen Stock Google Images auf der Ramus-Flotte und streamen die Oberfläche via WebRTC.
Was du damit machen kannst
- 1Automatisierte UI-TestsEin AI Agent kann mit mobilen Elementen interagieren, um das Applikationsverhalten zu verifizieren.
- 2Remote-Emulator-SteuerungEin Agent kann manuelle Eingaben wie Tippen oder Klicken auf einem Cloud-Device ausführen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Ramus Android MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenRamus Android MCP in Claude Code installieren
$ claude mcp add --transport http android-use https://api.ramus.dev/api/mcpRamus Android MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}Ramus Android MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"android-use": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}Ramus Android MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"android-use","type":"http","url":"https://api.ramus.dev/api/mcp"}'Ramus Android MCP in Codex installieren
$ codex mcp add android-use --url https://api.ramus.dev/api/mcpRamus Android MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.android-use] url = "https://api.ramus.dev/api/mcp"
Ramus Android MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http android-use https://api.ramus.dev/api/mcpRamus Android MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp",
"type": "http"
}
}
}Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarramus-dev/android-use is public and reachablegithub.com/ramus-dev/android-use ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-07github.com/ramus-dev/android-use ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeHTTPS endpoint answered 401 (sign-in required)Bestanden
README
Auf GitHub ansehenRamus 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.
Ramus Android MCP Fragen
Wie füge ich Ramus Android MCP zu Claude Code hinzu?
Führe claude mcp add --transport http android-use https://api.ramus.dev/api/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Ramus Android MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie kann ich Ramus mit einem MCP Client wie Claude Desktop oder Cursor nutzen?
Du kannst dich als Remote-Server über den streamable HTTP Endpoint verbinden, indem du deinen Ramus API Key in den Headern angibst.