Android MCP Toolkit

🚀 AIエージェント用Android MCPツールキット

3つのツールを備えた小型のMCPサーバーです：

• 高速なSVG → Android VectorDrawable変換（キャッシュ、ファイル、またはインライン）。
• パッケージ/プロセスID/タグフィルター付きのadb logcatリーダーで、クラッシュの迅速なトリアージが可能。
• 翻訳の長さの差を推定し、レイアウトが崩れる前に危険な長さの差を検出します。

開発背景

使命：AIエージェント時代にネイティブAndroidをもたらす

AIエコシステムがウェブ中心のツールで繁栄している一方で、Android開発はしばしば取り残されたように感じられます。このMCPサーバーは、そのギャップを埋めるためのもので、AIエージェントを直接Androidツールチェーンに接続する専用の架け橋となります。

⚡ ゼロフリクションのアセット変換：Android Studioを起動する手間なく、即座にSVGをVectorDrawableに変換します。

🔍 直接的な診断アクセス：エージェントがadb logcatストリームをリアルタイムで取得、フィルタリング、分析できるようにします（パッケージ、PID、またはタグで）。

🤖 エージェントネイティブアーキテクチャ：LLMが効率的に解析してアクションを起こせる構造化されたスクリプト可能な出力を提供します。

🚀 拡張性を持って構築：成長するための堅固な基盤で、将来的なユーティリティ（ビットマップヘルパーやアセット検証など）のための道を開きます。

連携アイデア

• Figma MCP：デザインからSVGを取得し、convert-svg-to-android-drawableに渡してAndroidリソース用のXMLを取得します。
• デバッグ：アプリを実行中に、パッケージ名またはタグでread-adb-logcatを呼び出して、MCPクライアントから離れることなくクラッシュとフィルタリングされたログをキャプチャします。

プレビュー

SVGからVectorDrawableへの変換

• Figmaリクエスト → SVG抽出
  
• フラグ変換プレビュー（単一）
  
• バッチフラグレビュー（並列）
  
• MCPを介したバッチ実行（コンソール）
  

ADB logcatツール

• クラッシュキャプチャプロンプト（入力 + フィルター）
  
• レスポンスプレビュー（要約されたlogcat）
  

現行ツール

• convert-svg-to-android-drawable

  • 入力: svg (インライン) または svgPath (ファイルパス)。オプション: outputPath, floatPrecision (デフォルト2), fillBlack (デフォルトfalse), xmlTag (デフォルトfalse), tint, cache (デフォルトtrue)。
  • 出力: VectorDrawableのXMLテキスト; outputPathが指定された場合はディスクにも書き込まれます。
  • パフォーマンス: SVG + オプションをキーとするLRUキャッシュ（32エントリ）とセッション内での高速再利用。
  • コンバーター: vendor/svg2vectordrawableにベンダーフォークがあり、rgb()/rgba(), hsl()/hsla(), および名前付きカラーの修正が含まれています。上流のライセンス: vendor/svg2vectordrawable/LICENSE (MIT)。

• manage-logcat

  • 入力:
    • action: read (デフォルト), crash, anr, または clear。
    • packageName: オプション。adb shell pidofを介してPIDを解決します。
    • pid: オプション。明示的なPID。
    • tag: オプション。タグでフィルタリングします（例: MyApp）。
    • priority: V, D, I, W, E, F, S (デフォルト V)。
    • maxLines: 末尾の行数（デフォルト200、最大2000）。
    • timeoutMs: デフォルト5000。
  • 動作:
    • read: logcatの末尾を取得します。
    • crash: logcat -b crashを取得します。
    • anr: 最近のActivityManager ANRログ + /data/anr/traces.txtの末尾を取得します。
    • clear: logcatバッファをクリアします。

• get-current-activity

  • 入力: timeoutMs (デフォルト 5000, 最大 15000)。
  • 動作: dumpsys windowを調べて、現在フォーカスされているアプリ/ウィンドウを見つけます。状態を検証するのに便利です。

• dump-ui-hierarchy

  • 入力: timeoutMs (デフォルト10000)。
  • 動作: uiautomatorを介して現在のUI階層をXMLとしてキャプチャします。

• take-screenshot

  • 入力: outputPath (必須), timeoutMs。
  • 動作: デバイスのスクリーンショットをローカルファイルに保存します。

• inject-input

  • 入力: command (tap, text, swipe, keyevent, back, home), args (配列), timeoutMs。
  • オプション: elementId または elementText (要素の中心を見つけてタップします)。
  • 動作: テストフローに適したユーザーインタラクションをシミュレートします。

• estimate-text-length-difference

  • 入力: sourceText (元のテキスト), translatedText (比較するテキスト), tolerancePercent (デフォルト 30, 最大 500)。
  • 動作: 両方の文字列のグラフェム長を測定し、パーセント変化を計算し、許容範囲を超えたかどうかを報告します（レイアウトを崩す可能性のある翻訳の長さの拡大をキャッチするのに役立ちます）。

ロードマップ（予定）

• Androidアセット用の追加のMCPツール（例: バッチ変換、検証、最適化ツール）。
• 一般的なAndroidドローアブル/テンプレート用のオプションのリソースプロンプト。

🚀 クイックスタート

• npm install
• npm run build
• node dist/index.js (stdio MCPサーバー)

npxを介して実行

• グローバル: npx android-mcp-toolkit

Cursorでの使用（MCP設定）

Cursorの設定JSONに追加します:

{
  "mcpServers": {
    "android-mcp-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "android-mcp-toolkit"
      ]
    }
  }
}

npx呼び出しは公開されたパッケージをダウンロードします; ローカルパスは必要ありません。

Cursorのディープリンクを介したクイックインストール:

• cursor://anysphere.cursor-deeplink/mcp/install?name=android-mcp-toolkit&config=eyJjb21tYW5kIjoibnB4IC15IGFuZHJvaWQtbWNwLXRvb2xraXQifQ%3D%3D

💻 使用例

基本的な使用法

• 入力SVG: sample_svg.svg
• 出力VectorDrawable: examples/sample_svg.xml

注意事項

• トランスポート: @modelcontextprotocol/sdkを介したstdio。
• 基本的な依存関係は最小限に抑えられており、SVGを変換するために必要なすべてのものがベンダー化/含まれています。

お問い合わせ

• nam.nv205106@gmail.com