MCP server Ramus Android
Commit 7 de nov. de 2026Fornece emuladores Android descartáveis na nuvem que permitem que agentes de IA executem APKs, interajam com elementos de UI, tirem screenshots e leiam logs do sistema.
Também conhecido como ramus-dev/android-use, android-use
- Stars
- 4
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 0.2.0
- Último commit
- 7 de nov. de 2026
- Licença
- MIT
O que é o MCP Ramus Android?
Ramus Android é um MCP server. Fornece emuladores Android descartáveis na nuvem que permitem que agentes de IA executem APKs, interajam com elementos de UI, tirem screenshots e leiam logs do sistema.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Ramus Android
O Ramus Android fornece emuladores Android descartáveis baseados em nuvem, projetados especificamente para agentes de codificação de IA. Ele permite que agentes interajam com ambientes móveis executando APKs e realizando ações por meio de uma série de ferramentas especializadas. Os usuários podem se conectar via um MCP server remoto usando uma conexão streamable HTTP, que requer uma chave de API do Ramus para autenticação. O sistema é compatível com vários clientes, incluindo Claude Desktop, Cursor, Windsurf e Gemini CLI.
Desenvolvedores utilizam este servidor para implementar um loop de observar, agir e verificar. O servidor expõe ferramentas com o prefixo android_ que permitem ao agente iniciar sessões, capturar o snapshot da árvore de UI, realizar taps, digitar, pressionar teclas, tirar screenshots e ler logs do sistema. Enquanto o MCP server remoto gerencia a execução das ferramentas, o CLI correspondente é necessário para uploads locais de APKs e para gerenciar o loop de desenvolvimento. Os emuladores executam imagens padrão do Google na frota Ramus e transmitem a interface via WebRTC.
O que você pode fazer com ele
- 1Testes de UI automatizadosUm agente de IA pode interagir com elementos móveis para verificar o comportamento do aplicativo.
- 2Controle remoto de emuladorUm agente pode realizar inputs de estilo manual, como digitar ou tocar em um dispositivo na nuvem.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP Ramus Android
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP Ramus Android no Claude Code
$ claude mcp add --transport http android-use https://api.ramus.dev/api/mcpInstalar o MCP Ramus Android no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}Instalar o MCP Ramus Android no VS Code
.vscode/mcp.json
{
"servers": {
"android-use": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}Instalar o MCP Ramus Android no VS Code CLI
$ code --add-mcp '{"name":"android-use","type":"http","url":"https://api.ramus.dev/api/mcp"}'Instalar o MCP Ramus Android no Codex
$ codex mcp add android-use --url https://api.ramus.dev/api/mcpInstalar o MCP Ramus Android no Codex config.toml
~/.codex/config.toml
[mcp_servers.android-use] url = "https://api.ramus.dev/api/mcp"
Instalar o MCP Ramus Android no Gemini CLI
$ gemini mcp add -s user --transport http android-use https://api.ramus.dev/api/mcpInstalar o MCP Ramus Android no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp",
"type": "http"
}
}
}Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelramus-dev/android-use is public and reachablegithub.com/ramus-dev/android-use ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-07github.com/ramus-dev/android-use ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPHTTPS endpoint answered 401 (sign-in required)Passou
README
Ver no 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.
Perguntas sobre o MCP Ramus Android
Como adiciono o MCP Ramus Android ao Claude Code?
Execute claude mcp add --transport http android-use https://api.ramus.dev/api/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP Ramus Android ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Como posso usar o Ramus com um cliente MCP como Claude Desktop ou Cursor?
Você pode se conectar como um servidor remoto usando o endpoint streamable HTTP, fornecendo sua chave de API do Ramus nos headers.