Ramus Android MCP server
Commit 7 Nov 2026Menyediakan emulator Android berbasis cloud yang bersifat disposable, memungkinkan AI agent untuk menjalankan APK, berinteraksi dengan elemen UI, mengambil screenshot, dan membaca system logs.
Juga dikenal sebagai ramus-dev/android-use, android-use
- Stars
- 4
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.2.0
- Commit terakhir
- 7 Nov 2026
- Lisensi
- MIT
Apa itu Ramus Android MCP?
Ramus Android adalah MCP server. Menyediakan emulator Android berbasis cloud yang bersifat disposable, memungkinkan AI agent untuk menjalankan APK, berinteraksi dengan elemen UI, mengambil screenshot, dan membaca system logs.
Ringkasan dibuat dari README proyek
Tentang Ramus Android MCP server
Ramus Android menyediakan emulator Android berbasis cloud yang bersifat disposable dan dirancang khusus untuk AI coding agent. Layanan ini memungkinkan agent untuk berinteraksi dengan lingkungan mobile dengan menjalankan APK dan melakukan berbagai tindakan melalui serangkaian tool khusus. Pengguna dapat terhubung melalui remote MCP server menggunakan koneksi streamable HTTP, yang memerlukan Ramus API key untuk autentikasi. Sistem ini kompatibel dengan berbagai client termasuk Claude Desktop, Cursor, Windsurf, dan Gemini CLI.
Developer menggunakan server ini untuk mengimplementasikan loop observe, act, dan verify. Server ini menyediakan tool dengan prefix android_ yang memungkinkan agent untuk memulai session, mengambil snapshot UI tree, tap, type, press, mengambil screenshot, dan membaca system logs. Meskipun remote MCP server menangani eksekusi tool, CLI pendamping tetap diperlukan untuk upload APK secara lokal dan mengelola development loop. Emulator ini menjalankan stock Google images pada fleet Ramus dan melakukan streaming interface melalui WebRTC.
Apa yang bisa Anda lakukan dengannya
- 1Automated UI testingAI agent dapat berinteraksi dengan elemen mobile untuk memverifikasi perilaku aplikasi.
- 2Remote emulator controlAgent dapat melakukan input bergaya manual seperti mengetik atau melakukan tap pada perangkat cloud.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Ramus Android MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Ramus Android MCP di Claude Code
$ claude mcp add --transport http android-use https://api.ramus.dev/api/mcpInstal Ramus Android MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}Instal Ramus Android MCP di VS Code
.vscode/mcp.json
{
"servers": {
"android-use": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}Instal Ramus Android MCP di VS Code CLI
$ code --add-mcp '{"name":"android-use","type":"http","url":"https://api.ramus.dev/api/mcp"}'Instal Ramus Android MCP di Codex
$ codex mcp add android-use --url https://api.ramus.dev/api/mcpInstal Ramus Android MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.android-use] url = "https://api.ramus.dev/api/mcp"
Instal Ramus Android MCP di Gemini CLI
$ gemini mcp add -s user --transport http android-use https://api.ramus.dev/api/mcpInstal Ramus Android MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp",
"type": "http"
}
}
}Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauramus-dev/android-use is public and reachablegithub.com/ramus-dev/android-use ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-07github.com/ramus-dev/android-use ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPHTTPS endpoint answered 401 (sign-in required)Lolos
README
Lihat di 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.
Pertanyaan tentang Ramus Android MCP
Bagaimana cara menambahkan Ramus Android MCP ke Claude Code?
Jalankan claude mcp add --transport http android-use https://api.ramus.dev/api/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Ramus Android MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Bagaimana cara menggunakan Ramus dengan MCP client seperti Claude Desktop atau Cursor?
Anda dapat terhubung sebagai remote server menggunakan endpoint streamable HTTP dengan menyertakan Ramus API key Anda di bagian headers.