MCP server Ramus Android
Коммит 7 нояб. 2026 г.Предоставляет временные облачные эмуляторы Android, которые позволяют AI-агентам запускать APK, взаимодействовать с элементами UI, делать скриншоты и читать системные логи.
Также известен как ramus-dev/android-use, android-use
- Звёзды
- 4
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 0.2.0
- Последний коммит
- 7 нояб. 2026 г.
- Лицензия
- MIT
Что такое Ramus Android MCP?
Ramus Android — это MCP server. Предоставляет временные облачные эмуляторы Android, которые позволяют AI-агентам запускать APK, взаимодействовать с элементами UI, делать скриншоты и читать системные логи.
Сводка сгенерирована из README проекта
О Ramus Android MCP server
Ramus Android предоставляет временные облачные эмуляторы Android, разработанные специально для AI-агентов программирования. Они позволяют агентам взаимодействовать с мобильными средами, запуская APK и выполняя действия с помощью набора специализированных инструментов. Пользователи могут подключаться через удаленный MCP server, используя streamable HTTP соединение, которое требует Ramus API key для аутентификации. Система совместима с различными клиентами, включая Claude Desktop, Cursor, Windsurf и Gemini CLI.
Разработчики используют этот сервер для реализации цикла «наблюдение, действие, проверка». Сервер предоставляет инструменты с префиксом android_, которые позволяют агенту запускать сессии, делать снимки UI-дерева, выполнять нажатия (tap), ввод текста (type), нажатия клавиш (press), делать скриншоты и читать системные логи. В то время как удаленный MCP server отвечает за выполнение инструментов, сопутствующий CLI необходим для локальной загрузки APK и управления циклом разработки. Эмуляторы работают на базе стандартных образов Google в инфраструктуре Ramus и транслируют интерфейс через WebRTC.
Что вы можете с ним делать
- 1Автоматизированное тестирование UIAI-агент может взаимодействовать с мобильными элементами для проверки поведения приложения.
- 2Удаленное управление эмуляторомАгент может выполнять ввод данных в ручном стиле, например, печатать текст или нажимать на элементы облачного устройства.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Ramus Android MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Ramus Android MCP в Claude Code
$ claude mcp add --transport http android-use https://api.ramus.dev/api/mcpУстановка Ramus Android MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}Установка Ramus Android MCP в VS Code
.vscode/mcp.json
{
"servers": {
"android-use": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}Установка Ramus Android MCP в VS Code CLI
$ code --add-mcp '{"name":"android-use","type":"http","url":"https://api.ramus.dev/api/mcp"}'Установка Ramus Android MCP в Codex
$ codex mcp add android-use --url https://api.ramus.dev/api/mcpУстановка Ramus Android MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.android-use] url = "https://api.ramus.dev/api/mcp"
Установка Ramus Android MCP в Gemini CLI
$ gemini mcp add -s user --transport http android-use https://api.ramus.dev/api/mcpУстановка Ramus Android MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp",
"type": "http"
}
}
}Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийramus-dev/android-use is public and reachablegithub.com/ramus-dev/android-use ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-07github.com/ramus-dev/android-use ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPHTTPS endpoint answered 401 (sign-in required)Пройдено
README
Открыть на 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.
Вопросы о Ramus Android MCP
Как добавить Ramus Android MCP в Claude Code?
Выполните claude mcp add --transport http android-use https://api.ramus.dev/api/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Ramus Android MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Как использовать Ramus с MCP-клиентом, таким как Claude Desktop или Cursor?
Вы можете подключиться как к удаленному серверу через streamable HTTP endpoint, указав свой Ramus API key в заголовках.