Ramus Android MCPサーバー
コミット 2026年11月7日AIエージェントがAPKの実行、UI要素の操作、スクリーンショットの取得、システムログの読み取りを行える、使い捨てのクラウドAndroidエミュレータを提供します。
別名 ramus-dev/android-use, android-use
- スター
- 4
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.2.0
- 最終コミット
- 2026年11月7日
- ライセンス
- MIT
Ramus Android MCPとは
Ramus AndroidはMCPサーバーです。 AIエージェントがAPKの実行、UI要素の操作、スクリーンショットの取得、システムログの読み取りを行える、使い捨てのクラウドAndroidエミュレータを提供します。.
プロジェクトのREADMEから生成された概要
Ramus Android MCP server について
Ramus Androidは、AIコーディングエージェント向けに特別に設計された、使い捨てのクラウドベースAndroidエミュレータを提供します。一連の専用ツールを通じて、エージェントがAPKを実行し、アクションを実行することで、モバイル環境とのインタラクションを可能にします。ユーザーは、認証にRamus APIキーを必要とするstreamable HTTP接続を使用して、リモートMCP server経由で接続できます。このシステムは、Claude Desktop、Cursor、Windsurf、Gemini CLIを含むさまざまなクライアントと互換性があります。
開発者は、このserverを使用して「観察、実行、検証」のループを実装できます。このserverは、エージェントがセッションの開始、UIツリーのスナップショット取得、タップ、タイピング、プレス、スクリーンショットの取得、システムログの読み取りを行えるよう、android_で始まるツールを公開しています。リモートMCP serverがツールの実行を処理する一方で、ローカルへのAPKアップロードや開発ループの管理には、付属のCLIが必要です。エミュレータはRamusのフリート上でstock Googleイメージを実行し、WebRTCを介してインターフェースをストリーミングします。
できること
- 1UIテストの自動化AIエージェントがモバイル要素と対話して、アプリケーションの動作を検証できます。
- 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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Claude DesktopやCursorなどのMCPクライアントでRamusを使用するにはどうすればよいですか?
ヘッダーにRamus APIキーを含めることで、streamable HTTPエンドポイントを使用したリモートサーバーとして接続できます。