AndroJack MCP

AndroJack — Android開発を幅広くこなす万能ツール

AI コーディングアシスタントに、最新かつ検証済みの Android 知識を提供する MCP サーバーです。記憶ではなく、公式情報をもとに開発できます。

以下でも動作します： Windsurf · VS Code Copilot · Google Antigravity · JetBrains AI — 下記の手動設定をご覧ください ↓

VS Code での配布： VS Code Marketplace でもAndroJack MCP for VS Codeとして公開中です。

目次

• このツールを生んだ危機
• 実際に何が問題になるのか
• AndroJack ができること
• 正直な有効化モデル
• レベル 3 でも起こりうる問題
• 多層防御
• 決め手となる主張
• 23 のツール
• クイックスタート
• 手動設定
• エコシステム：Google のファーストパーティ製ツール
• セキュリティとプライバシー
• 変更履歴

🔥 このツールを生み出した危機

2025 年、Stack Overflow Developer Survey は 49,000 人の開発者に、AI コーディングツールの利用経験について尋ねました。その結果は、すべての Android エンジニアが危機感を抱くべきものです。

• 開発者の 84% が現在 AI コーディングツールを利用しており、前年の 76% から増加しています。
• AI の正確性に対する**信頼は 40% からわずか 29% へと、わずか 1 年で急落しました。
• 2025 年の Stack Overflow への全アクセスの 35% は、開発者が AI 生成コードのデバッグや修正を行うために訪れたものです。

利用率と信頼の間にある隔たりは、偶然ではありません。これは構造的な問題の結果です。AI モデルが予測するのはトークンであり、API ではありません。 AI モデルは過去のある時点の情報で訓練されており、API 30 で何が変わったのか、Google I/O 2025 で何が発表されたのか、あるいは Google Play が現在審査時に何を却下するのかを知る仕組みがありません。

Android 開発者にとって、この問題は特に危険です。Android はモバイル開発のエコシステムの中で最も変化が速く、毎月新しい Compose BOM が登場し、7 年を経て Navigation 3 が安定版になり、Android 16 では画面の向きのロックに関するルールが一新されています。その一方で、ほとんどの AI ツールは、利用する時点で 6 か月から 2 年前のデータで訓練されています。

その結果は、単にコードの質が低いだけではありません。自信たっぷりの低品質なコードなのです。

⚡ 実際に問題となること — 記録された事例

これらは仮説上のリスクではありません。実際の開発者プロジェクトで記録された障害モードです。

🧩 AndroJack の機能

AndroJack は、ドキュメントに基づく Android エンジニアリング向け MCP サーバーです。公式の Android および Kotlin の情報源から、最新かつ検証済みの回答を取得する23 個の専用ツールを AI コーディングアシスタントに提供し、古いトレーニングデータからの予測に頼らずに済むようにします。

AI 自体を賢くするものではありません。AI に根拠を示す責任を持たせます。

LLM 向けのビルド前リンターと考えてください。他のツールがドキュメントを取得するのに対し、AndroJack は厳格なアーキテクチャの門番として機能します。

Without AndroJack:  You ask → AI predicts from stale weights → Code (possibly wrong)

With AndroJack:     You ask → AI calls tool → Tool fetches official source live
                             → AI reads verified answer → Code (grounded)

⚠️ 正直な有効化モデル — 2 つのレベル

重要

AndroJack をインストールする前に、最も重要な点を理解してください。

レベル 1 は受動的です。 ツールは利用できますが、いつ使うかは AI が判断します。Compose 画面を構築する AI は architecture_reference を呼び出しても、material3_expressive を呼び出さないことがあり、その結果、M3E 違反が気づかれないままリリースされる可能性があります。

レベル 2 は能動的です。 androjack_grounding_gate システムプロンプトは、タスクの種類ごとに適切なツールを指定します。Compose UI を構築する場合、AI はまず material3_expressive を呼び出すことを義務づけられています。依存関係を追加する場合は、gradle_dependency_checker を呼び出す必要があります。例外はありません。

レベル 3 はループバックです。 android_code_validator は、AI が生成したすべてのコードブロックをユーザーに返す前に検査します。削除済み API、非推奨パターン、Android 16/17 への準拠、Compose-First への移行シグナルを対象とする 34 個のルールが含まれています。コメントは無視されるため、// replaced AsyncTask のような移行メモが誤って FAIL になることはありません。結果はテキストと出力スキーマ付きの structuredContent で返されます。判定が FAIL の場合、AI は修正して再検証する必要があり、問題のあるコードがユーザーに表示されることはありません。

→ 根拠に基づく完全な動作を実現するには、常にレベル 2 + レベル 3 を有効にしてください。以下の「完全な保証を得る」を参照してください。

🪲 レベル 3 でも起こり得る問題

重要

AndroJack は、ドキュメントに基づく情報確認と API 検証のためのツールです。Compose のレイアウトエンジンでも、デザインシステムの適用を強制するツールでも、実行時のレンダラーでもありません。レベル 3 では、削除済み API や非推奨パターンを検出できますが、Android のあらゆる種類のバグを検出できるわけではありません。これは AndroJack の制約ではなく、視覚的に描画される実行時 UI フレームワークに静的なテキスト解析を適用することの根本的な性質です。

以下は、レベル 2（v1.4.0）の AndroJack を使って実際に構築された Android アプリで発生したバグです。注意すべき点と、別のツールを使うべき場面が正確にわかるよう、ここではありのままに記録しています。

✅ レベル 3 で検出できる問題

// ❌ REMOVED — android_code_validator fires: REMOVED_ASYNCTASK
class MyTask : AsyncTask<Void, Void, String>()

// ❌ REMOVED — fires: REMOVED_TEST_COROUTINE_DISPATCHER
val dispatcher = TestCoroutineDispatcher()

// ❌ DEPRECATED — fires: DEPRECATED_CONTEXTUAL_FLOW_ROW
ContextualFlowRow { Text("hello") }

// ❌ LEAK — fires: GLOBALSCOPE_LAUNCH
GlobalScope.launch { fetchData() }

⚠️ レベル 3 では検出できないこと

警告

以下のバグは実際のプロジェクトで見つかったものです。Compose のコードとしては有効で、現在の API に準拠していますが、デザインシステムの制約、アクセシビリティの最低基準、またはアーキテクチャ上の境界に違反しています。静的なテキストスキャンでは検出できません。

// Compiles and runs. Level 3 sees no violation.
// The bug: Text inside MultiChoiceSegmentedButtonRow truncates because a
// fixed height modifier prevents the Roboto Flex variable font from expanding.
MultiChoiceSegmentedButtonRow {
    SegmentedButton(/* fixed height modifier */) {
        Text("Light")
    }
}

// Correct Material 3 API. Level 3 sees no violation.
// The bug: disabled state colours fail WCAG AA 4.5:1 contrast against surface.
Button(enabled = false, onClick = {}) {
    Text("INITIALIZE VAULT")
}

// A missing try/catch produces no pattern match.
class VaultViewModel : ViewModel() {
    fun initializeVault() {
        viewModelScope.launch {
            val result = repository.initialize() // Missing try/catch
            _uiState.value = UiState.Success(result)
        }
    }
}

🗂️ 多層防御：バグの種類に応じた適切なツール

🎯 決め手となる問い

「あなたの agents.md ファイルで、先週火曜日にリリースされた Gradle のバージョンがわかりますか？」

どの Markdown ファイルでもわかりません。.cursorrules のルールでもわかりません。SKILL.md でもわかりません。

✅ それを実行できるのは、ライブのツール呼び出しだけです。

それこそが AndroJack の役割です。そして、現在のエコシステムには、Android に特化してこれを行うものはほかにありません。

プロンプトエンジニアリングは AI の応答方法を制御します。MCP は AI が知っていることを制御します。

✨ AndroJack がカバーする内容 — 23 個のツール

🚀 クイックスタート — インストール不要

オプション 1 — 対話型 CLI（v2.1.0）✨ 推奨

npx -y [email protected] install

VS Code、Cursor、Claude、Windsurf、JetBrains、Kiro、Antigravity を自動検出する、アニメーション付きのターミナルウィザードを起動します。

オプション 2 — 対象を指定したインストール

# Preview detected IDEs and config paths
npx -y [email protected] install --list

# Auto-detect all
npx -y [email protected] install --auto

# Install to a specific IDE
npx -y [email protected] install --ide=cursor
npx -y [email protected] install --ide=claude
npx -y [email protected] install --ide=vscode
npx -y [email protected] install --ide=windsurf
npx -y [email protected] install --ide=jetbrains
npx -y [email protected] install --ide=kiro
npx -y [email protected] install --ide=antigravity

オプション 3 — IDE を使わずにテスト

npx -y @modelcontextprotocol/inspector npx -y [email protected]

オプション 4 — CI でルールを適用（2.1.0 の新機能）

エージェントに適用されるものと同じルールエンジンを、エージェントが触れていないコードも含め、すべてのプルリクエストで実行します。

npx -y [email protected] validate app/src --target-sdk=37            # exit 1 on errors
npx -y [email protected] validate . --format=sarif > androjack.sarif  # GitHub code scanning

# .github/workflows/androjack.yml
- run: npx -y [email protected] validate . --target-sdk=37 --format=sarif > androjack.sarif || true
- uses: github/codeql-action/upload-sarif@v3
  with: { sarif_file: androjack.sarif }
- run: npx -y [email protected] validate . --target-sdk=37   # fails the job on errors

フラグ：--format=text|json|sarif、--target-sdk=N、--min-sdk=N、--fail-on=error|warning|never。終了コード：0 は合格、1 は違反あり、2 は使用方法のエラー またはスキャンですべてを確認できなかった場合（一致するファイルがない、ファイルサイズが 1 MiB 超、またはファイル数が上限の 20k に達した場合）です。部分スキャンでゲートが合格になることはありません。

オプション設定

🧩 手動設定／コピー／貼り付け

サーバーを手動で接続する場合や、書き込む前に正確な JSON を確認したい場合は、次の手順を行ってください。

• npx -y [email protected] install --list を実行すると、検出された IDE と対象の設定パスをプレビューできます。
• すぐに貼り付けて使える例は config/ にあります。

どの例もデフォルトでは AndroJack をローカルで実行し、公開済みパッケージを npx -y [email protected] 経由で起動します。

📍 エコシステム：AndroJack と Google のファーストパーティーエージェントツール

Google は現在、Android 向けの独自のエージェントスタックを提供しています。機能が重複する点について、率直に説明します。

**推奨セットアップ：**検索とタスクスキルには Google のツールを使用し、強制チェックには AndroJack を使用します。エージェントのループ内では android_code_validator を、CI では androjack-mcp validate を使います。AndroJack は Google 独自のドキュメントインデックスより優れた検索を目指すものではありません。ANDROJACK_DEVELOPER_KNOWLEDGE_API_KEY を設定すると、そのインデックスを使用します。

🔒 セキュリティとプライバシー

📋 変更履歴

v2.1.0 — 動作しなかった部分を修正し、動作していた部分を強化して、CI で徹底

• ドキュメント検索で実際にドキュメントが返るようになりました。 v2.0 ではクライアント側でレンダリングされる検索ページをスクレイピングしていたため、どのクエリでもドキュメントが返されませんでした。2.1 では、Google Developer Knowledge API（任意のキー）または検証済みの正規ページのインデックスを使用します。
• セキュリティ： リダイレクトによる許可リストの回避を解消しました。フェッチしたすべてのコンテンツが信頼できないコンテンツの境界を通るようになりました（v2.0 では対応を謳っていましたが、実際に対応していたのは 1 つのツールだけでした）。境界タグの偽装とゼロ幅文字／全角文字による回避を修正しました。HTTP セッション枯渇による DoS を修正しました。ベアラー認証とステートレスモードを追加しました。7 件の依存関係の脆弱性（うち 1 件は重大）にパッチを適用しました。
• 誤った回答を自信満々に返すことを防止： レジストリでの Row →「非推奨」、Task →「削除済み」の誤検出を修正しました。Android 17 のゲームに関する例外を修正しました。架空の Handoff API を削除しました。Room 3 が安定版になりました（以前はアルファ版と説明されていました）。Google Maven のアルファ版に「最新の安定版」というラベルが付かなくなりました。リンク切れのドキュメントリンクを 19 件置き換えました。
• バリデーター： コメントを無視するようにしました（エージェントの修正ループを解消）。Kotlin DSL の kapt(...) を検出するようになりました。API 37 のしきい値を修正しました。Android 17 向けの新しいルールを 6 件追加しました（合計 34 件）。構造化出力に対応しました。
• 新機能： CI 向けの androjack-mcp validate CLI（テキスト／JSON／SARIF）、ルールカタログの MCP リソース、すべてのツールへの注釈、AppFunctions のガイダンス、Android Studio Rabbit 1／AGP 9.4 に対応しました。
• トークンコストを削減： tools/list を約 28.5 KB から約 20.5 KB に削減しました。セッション内で同じ結果が繰り返される場合は短いポインターに置き換えられます（再取得するには refresh: true を渡してください）。
• テスト： 85 件から 196 件に増加しました（オプトインのライブテスト 1 件を含む）。実際の MCP SDK クライアントを通じて実行する、17 シナリオのブラックボックス UAT スイートも含まれます。test/uat/UAT_PLAN.md をご覧ください。

詳細については、CHANGELOG.md をご覧ください。

v2.0.0 — セキュリティ強化、Compose Firstへの移行、開発者認証

• 間接的なプロンプトインジェクションに対するコンテンツサニタイザー — src/content-sanitizer.ts は、外部から取得したテキストが呼び出し元エージェントのコンテキストに届く前に、構造的なインジェクションパターン（偽のロールマーカー、指示をリセットする形式）を無害化します。自由記述のユーザー投稿コンテンツをインデックス化する唯一の許可リスト登録ドメインである issuetracker.google.com からの android_debugger の結果は、明示的な信頼できないデータ境界で囲みます。
• 依存関係の脆弱性を修正 — cheerio の更新により、推移的依存関係の undici／qs にある7件の脆弱性（うち重大度の高いもの3件）を解消しました。破壊的変更はなく、出荷ツリー内の脆弱性は0件です。
• ツール23：android_developer_verification — Googleの開発者認証プログラムは、2026年9月30日から適用されます（ブラジル、インドネシア、シンガポール、タイが先行し、2027年に全世界で適用）。登録方法、タイムライン、企業向けの適用除外、CI/CD一括登録APIについて説明します。
• Compose Firstへのプラットフォーム移行を反映 — 2026年5月19日現在、Android UI開発は公式にCompose Firstとなっています。Viewベースのパターン（Fragments、RecyclerView、ViewPager）は、照会された場合にメンテナンスモードとして示されます。古い情報をそのまま放置せず、Google自身の発表を直接参照しています。
• Compose 1.11 v2 Testing Framework — 新しい既定の StandardTestDispatcher の動作に関する完全な移行ガイドに加え、以前の前提を検出するバリデータールール（UNCONFINED_DISPATCHER_COMPOSE_TEST）を追加しました。
• Navigation 3 Scene Decorators（1.1） — 各画面を意識せずに、永続的なUI要素（ボトムバー、レール、ダイアログ）を利用できます。
• Android Studioのコードネームを修正 — 以前はコードネームが2世代遅れて「Panda 2」でした。現在は、現行の安定版を Quail（2026.1.x）、AGPを9.2.0として正しく反映しています。
• Android Skillsの位置づけ — Googleのファーストパーティ製Android Skills／CLI（2026年4月）について説明し、AndroJackのバリデーターを競合する検索レイヤーではなく、生成後の補完的な強制チェックゲートとして位置づけています。
• バリデータールール28件（以前は26件） — UNCONFINED_DISPATCHER_COMPOSE_TEST と NEW_FRAGMENT_CLASS_COMPOSE_FIRST を追加しました。
• 架空のバージョン番号を削除 — 以前のセッションで、依存関係のバージョンカタログの例に未確認のバージョン番号がいくつか記載されていました。確認済みの値だけに置き換え、明示的な CHECK_LIVE_VIA_gradle_dependency_checker プレースホルダーを追加しました。
• バージョンを完全に同期 — src/version.ts の更新が package.json、すべてのIDE設定ファイル、マニフェストファイルに反映されていなかった問題を解消しました。現在はリリースチェックリストの項目として徹底しています。

v1.7.1 — エンジニアリングの強化とコミュニティとの機能同等性

• 54件のテストカバレッジ — バリデータールール、HTMLパーサー、LRUキャッシュ、HTTPセキュリティレイヤーに対する包括的なユニットテストとコントラクトテストを実装しました。
• ディスカバリー機能の同等性 — /.well-known/mcp エンドポイントが tools: 22 を正しく報告するよう修正しました。
• 依存関係のサニタイズ — node-fetch を削除してネイティブの fetch に移行し、古くなったオーバーライドを整理して、よりクリーンなサプライチェーンを実現しました。
• ルールの強化 — NavHost と BottomAppBar のComposeコンポーネント検出を改善しました。
• URLの修正 — Android 17の ACCESS_LOCAL_NETWORK と handoff に関する、壊れていたドキュメントのアンカーを修正しました。

v1.7.0 — Android 17／API 37のサポート

• ツール22：android_api17_compliance — Android 17のプラットフォーム安定性に関する完全なリファレンス（2026年3月26日）。
• バリデータールールの拡張 — (2.1.0で訂正：このリリースノートでは、出荷されなかったRoom 3.0および ACCESS_LOCAL_NETWORK のチェックを含め、ルール数を31件と誤って記載していました。実際の件数は、2.0.0で26件から28件、2.1.0で34件です。)
• WindowManager 1.5.0 — Large（1200dp）およびExtra-large（1600dp）のブレークポイントとレイアウトパターンを追加しました。
• Room 3.0アルファ版 — 最新のSQLiteDriverへの移行パスをサポートします。

👥 著者と所有者

Vikas Sahani — プロダクトリード（[email protected]）
Claude AI — AI エンジニアリングリード