Ramus Android MCP server
2026년 11월 7일 커밋AI agent가 APK를 실행하고, UI 요소와 상호작용하며, 스크린샷을 찍고 시스템 로그를 읽을 수 있는 일회용 클라우드 Android 에뮬레이터를 제공합니다.
다른 이름 ramus-dev/android-use, android-use
- 스타
- 4
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.2.0
- 마지막 커밋
- 2026년 11월 7일
- 라이선스
- MIT
Ramus Android MCP란?
Ramus Android은(는) MCP server입니다. AI agent가 APK를 실행하고, UI 요소와 상호작용하며, 스크린샷을 찍고 시스템 로그를 읽을 수 있는 일회용 클라우드 Android 에뮬레이터를 제공합니다.
프로젝트 README에서 생성된 요약
Ramus Android MCP server 정보
Ramus Android는 AI 코딩 에이전트를 위해 특별히 설계된 일회용 클라우드 기반 Android 에뮬레이터를 제공합니다. 에이전트는 APK를 실행하고 일련의 특화된 도구를 통해 동작을 수행함으로써 모바일 환경과 상호작용할 수 있습니다. 사용자는 인증을 위해 Ramus API key가 필요한 streamable HTTP 연결을 사용하여 원격 MCP server로 연결할 수 있습니다. 이 시스템은 Claude Desktop, Cursor, Windsurf, Gemini CLI를 포함한 다양한 클라이언트와 호환됩니다.
개발자는 관찰(observe), 실행(act), 검증(verify) 루프를 구현하기 위해 이 server를 사용합니다. 이 server는 에이전트가 세션을 시작하고, UI 트리를 스냅샷하고, tap, type, press를 수행하며, 스크린샷을 찍고 시스템 로그를 읽을 수 있도록 android_ 접두사가 붙은 도구들을 노출합니다. 원격 MCP server가 도구 실행을 처리하는 동안, 로컬 APK 업로드 및 개발 루프 관리를 위해서는 함께 제공되는 CLI가 필요합니다. 에뮬레이터는 Ramus 플릿에서 stock Google 이미지를 실행하며 WebRTC를 통해 인터페이스를 스트리밍합니다.
활용 사례
- 1자동 UI 테스트AI agent가 모바일 요소와 상호작용하여 애플리케이션 동작을 검증할 수 있습니다.
- 2원격 에뮬레이터 제어에이전트가 클라우드 디바이스에서 타이핑이나 탭과 같은 수동 방식의 입력을 수행할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Ramus Android MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Ramus Android MCP 설치
$ claude mcp add --transport http android-use https://api.ramus.dev/api/mcpCursor에 Ramus Android MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}VS Code에 Ramus Android MCP 설치
.vscode/mcp.json
{
"servers": {
"android-use": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}VS Code CLI에 Ramus Android MCP 설치
$ code --add-mcp '{"name":"android-use","type":"http","url":"https://api.ramus.dev/api/mcp"}'Codex에 Ramus Android MCP 설치
$ codex mcp add android-use --url https://api.ramus.dev/api/mcpCodex config.toml에 Ramus Android MCP 설치
~/.codex/config.toml
[mcp_servers.android-use] url = "https://api.ramus.dev/api/mcp"
Gemini CLI에 Ramus Android MCP 설치
$ gemini mcp add -s user --transport http android-use https://api.ramus.dev/api/mcpGemini settings.json에 Ramus Android MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능ramus-dev/android-use is public and reachablegithub.com/ramus-dev/android-use ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스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통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기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 질문
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 구성을 사용합니다.
Claude Desktop 또는 Cursor와 같은 MCP 클라이언트에서 Ramus를 어떻게 사용하나요?
헤더에 Ramus API key를 제공하여 streamable HTTP 엔드포인트를 통해 원격 서버로 연결할 수 있습니다.