Ramus Android MCP sunucusu
Commit 7 Kas 2026AI agent'ların APK çalıştırmasına, kullanıcı arayüzü (UI) öğeleriyle etkileşime girmesine, ekran görüntüsü almasına ve sistem günlüklerini okumasına olanak tanıyan geçici bulut tabanlı Android emülatörleri sağlar.
Ayrıca bilinen adı ramus-dev/android-use, android-use
- Yıldızlar
- 4
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.2.0
- Son commit
- 7 Kas 2026
- Lisans
- MIT
Ramus Android MCP nedir?
Ramus Android bir MCP sunucusudur. AI agent'ların APK çalıştırmasına, kullanıcı arayüzü (UI) öğeleriyle etkileşime girmesine, ekran görüntüsü almasına ve sistem günlüklerini okumasına olanak tanıyan geçici bulut tabanlı Android emülatörleri sağlar.
Özet, projenin README dosyasından oluşturuldu
Ramus Android MCP sunucusu hakkında
Ramus Android, özellikle yapay zeka kodlama agent'ları için tasarlanmış, geçici bulut tabanlı Android emülatörleri sunar. Agent'ların APK çalıştırmasına ve bir dizi özelleşmiş araç aracılığıyla eylemler gerçekleştirmesine imkan tanıyarak mobil ortamlarla etkileşime girmelerini sağlar. Kullanıcılar, kimlik doğrulama için bir Ramus API anahtarı gerektiren streamable HTTP bağlantısı üzerinden uzak bir MCP server'a bağlanabilirler. Sistem; Claude Desktop, Cursor, Windsurf ve Gemini CLI dahil olmak üzere çeşitli istemcilerle uyumludur.
Geliştiriciler, bir gözlemle, eyleme geç ve doğrula döngüsü uygulamak için bu server'ı kullanırlar. Server, bir agent'ın oturum başlatmasına, UI ağacının anlık görüntüsünü almasına, dokunmasına, yazmasına, tuşlara basmasına, ekran görüntüsü almasına ve sistem günlüklerini okumasına olanak tanıyan android_ ön ekli araçlar sunar. Uzak MCP server araç yürütme işlemlerini yönetirken, yerel APK yüklemeleri ve geliştirme döngüsünü yönetmek için beraberindeki CLI gereklidir. Emülatörler, Ramus filosunda orijinal Google imajlarını çalıştırır ve arayüzü WebRTC üzerinden akış olarak sunar.
Neler yapabilirsiniz
- 1Otomatik UI testiBir AI agent, uygulama davranışlarını doğrulamak için mobil öğelerle etkileşime girebilir.
- 2Uzak emülatör kontrolüBir agent, bulut tabanlı bir cihaz üzerinde yazma veya dokunma gibi manuel tarzda girişler gerçekleştirebilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Ramus Android MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleRamus Android MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http android-use https://api.ramus.dev/api/mcpRamus Android MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}Ramus Android MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"android-use": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}Ramus Android MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"android-use","type":"http","url":"https://api.ramus.dev/api/mcp"}'Ramus Android MCP'yi Codex içine yükleyin
$ codex mcp add android-use --url https://api.ramus.dev/api/mcpRamus Android MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.android-use] url = "https://api.ramus.dev/api/mcp"
Ramus Android MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http android-use https://api.ramus.dev/api/mcpRamus Android MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp",
"type": "http"
}
}
}Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirramus-dev/android-use is public and reachablegithub.com/ramus-dev/android-use ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-07github.com/ramus-dev/android-use ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorHTTPS endpoint answered 401 (sign-in required)Geçti
Ramus 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 soruları
Ramus Android MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http android-use https://api.ramus.dev/api/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Ramus Android MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Ramus'u Claude Desktop veya Cursor gibi bir MCP istemcisiyle nasıl kullanabilirim?
Header kısmında Ramus API anahtarınızı belirterek streamable HTTP uç noktası üzerinden uzak bir sunucu olarak bağlanabilirsiniz.