@amazon-devices/amazon-devices-buildertools-mcp 0.1.26 → 0.1.30

package/README.ja.md

@@ -22,6 +22,10 @@ Amazon Devices Builder Tools MCPは以下の機能をサポートしています
 | **フォーカス管理** | TVインターフェース用のD-Padナビゲーションとフォーカス管理を実装 | <ul><li>`フォーカス管理を示すために2つのボタンを持つアプリを作成できますか？`</li></ul> |
 | **SDK & CLI** | SDKのインストール/更新と、仕様駆動型CLIを介した効率的なCLIツールの実行 | <ul><li>`AIエージェントからSDKをインストール/更新`</li><li>`アプリをビルド`</li><li>`仮想デバイスでアプリを実行`</li><li>`物理デバイスでアプリを実行`</li><li>`KPI Visualizerを実行してパフォーマンス結果を取得`</li></ul> |
 | **クラッシュ分析**              | JavaScript、Native、LMK、ANRクラッシュの自動ACR分析による診断                    | <ul><li>`なぜアプリがクラッシュしたのですか？`</li><li>`このACRファイルを分析してください /path/to/crash.acr`</li></ul>                                                                                                                                                                                                                                                |
+| **キー入力レイテンシー**          | JSスレッドパフォーマンスと入力イベント分析によるキー入力レイテンシーの問題を診断・解決 | <ul><li>`なぜアプリのキー入力が遅いのですか？`</li><li>`Vegaアプリのキー入力レイテンシーを診断してください`</li><li>`ボタンクリックが遅く感じます、助けてください`</li></ul>                                                                                                                                                 |
+| **UI流暢性**                | コンポーネント再レンダリングとCPUパフォーマンス分析によるUI流暢性KPI障害の診断    | <ul><li>`アプリのUI流暢性スコアが低いです、診断してください`</li><li>`Vegaアプリのフレームドロップとジャンクを修正してください`</li><li>`アプリのスクロールがスムーズでないのはなぜですか？`</li></ul>                                                                                                                                                |
+| **アプリ移行**              | 視覚的・機能的一貫性を維持しながらFireOS WebViewアプリをVega WebViewアプリに変換 | <ul><li>`FOS WebViewアプリをVega Webアプリに変換してください`</li><li>`/path/to/fos-appにあるFireOS Webアプリをvegaに移行してください`</li></ul>                                                                                                                                                                                            |
+| **Appstore IAP統合**   | VegaアプリでAmazon Appstoreアプリ内課金（IAP）SDKを統合・テスト                      | <ul><li>`VegaアプリにIAPを統合してください`</li><li>`Vegaアプリのアプリ内課金をセットアップするにはどうすればよいですか？`</li><li>`VegaアプリでIAPをテストしてください`</li></ul>                                                                                                                                                                      |
 | **フィードバックの提供** | MCPの使用体験についてAmazonにフィードバックを提供 | <ul><li>`フィードバックを提供したい`</li><li>`Vega MCPのフィードバックを提供するにはどうすればよいですか？`</li></ul> |
 
 ## ワンクリックインストール
@@ -36,10 +40,6 @@ Amazon Devices Builder Tools MCPは以下の機能をサポートしています
 
 [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=amazon-devices-buildertools-mcp&config=eyJjb21tYW5kIjoibnB4IC15IEBhbWF6b24tZGV2aWNlcy9hbWF6b24tZGV2aWNlcy1idWlsZGVydG9vbHMtbWNwQGxhdGVzdCJ9)
 
-### VSCodeにMCPをインストール
-
-[Add to VSCode](vscode:mcp/install?%7B%22name%22%3A%22amazon-devices-buildertools-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40amazon-devices%2Famazon-devices-buildertools-mcp%40latest%22%5D%7D)
-
 
 ## スクリプトによるインストール
 
@@ -229,6 +229,10 @@ Amazon Devices Builder Tools MCPが提供するツールをリストしてくだ
 - analyze_perfetto_traces
 - read_document
 - list_documents
+- diagnose_crash
+- diagnose_key_input_latency
+- diagnose_ui_fluidity
+- convert_fos_webview_to_vega
 
 ## MCPツール
 
@@ -386,3 +390,50 @@ Amazon Devices Builder Tools MCPは、AIエージェントの`/prompts`でワン
 ```
 > @diagnose_crash /path/to/crash.acr
 ```
+
+### 7. `diagnose_key_input_latency`
+
+**説明:** JSスレッドパフォーマンス、CPUボトルネック、入力イベント処理の最適化を体系的に分析し、React Native Vegaアプリのキー入力レイテンシーの問題を診断・解決します。
+
+**パラメータ:**
+
+- `vega_app_package_path`（必須、文字列）: Vegaアプリパッケージのルートディレクトリへの絶対パス
+- `app_process_name`（任意、文字列）: 入力レイテンシーが発生しているアプリプロセスの名前。指定しない場合、manifest.tomlから自動的に解決されます。
+- `perfetto_trace_file_path`（任意、文字列）: 既存のPerfettoトレースファイルへの絶対パス（既にキャプチャ済みの場合）
+- `target_component_or_button`（任意、文字列）: 調査する特定のボタンまたはコンポーネント名
+- `latency_threshold_ms`（任意、数値）: 許容される最大入力レイテンシー（ミリ秒）。デフォルトは100。
+
+**使用例:**
+
+```
+> @diagnose_key_input_latency /path/to/my-vega-app
+```
+
+### 8. `diagnose_ui_fluidity`
+
+**説明:** コンポーネント再レンダリングとCPUパフォーマンスボトルネックの体系的な分析を通じて、React Native VegaアプリのUI流暢性KPI障害を診断します。
+
+**パラメータ:**
+
+- `vega_app_package_path`（必須、文字列）: Vegaアプリパッケージのルートディレクトリへの絶対パス
+
+**使用例:**
+
+```
+> @diagnose_ui_fluidity /path/to/my-vega-app
+```
+
+### 9. `convert_fos_webview_to_vega`
+
+**説明:** VegaのWebViewコンポーネントを使用して、視覚的・機能的一貫性を維持しながら、既存のFireOS WebViewアプリケーションをVega WebViewアプリケーションに変換します。
+
+**パラメータ:**
+
+- `fos_app_workspace_path`（必須、文字列）: FireOS Webアプリのソースコードへのパス
+- `vega_app_workspace_path`（必須、文字列）: Vegaアプリを作成するパス
+
+**使用例:**
+
+```
+> @convert_fos_webview_to_vega /path/to/fos-web-app /path/to/vega-app
+```

package/README.md

@@ -22,6 +22,10 @@ The Amazon Devices Builder Tools MCP supports the following capabilities:
 | **Focus Management**           | Implement D-Pad navigation and focus management for TV interfaces                                | <ul><li>`Can you create an app with 2 buttons to show case focus management?`</li></ul>                                                                                                                                                                                                                                              |
 | **Give Feedback** | Provide feedback to Amazon about your experience with the MCP | <ul><li>`I want to provide feedback`</li><li>`How can I provide vega mcp feedback?`</li></ul> |
 | **Crash Analysis**              | Diagnose JavaScript, Native, LMK, and ANR crashes with automated ACR analysis                    | <ul><li>`Why did my app crash?`</li><li>`Help me analyze this ACR file /path/to/crash.acr`</li></ul>                                                                                                                                                                                                                                                |
+| **Key Input Latency**          | Diagnose and resolve key input latency issues through JS Thread performance and input event analysis | <ul><li>`Why is my app responding slowly to key presses?`</li><li>`Help me diagnose key input latency in my Vega app`</li><li>`My button clicks feel laggy, can you help?`</li></ul>                                                                                                                                                 |
+| **UI Fluidity**                | Diagnose UI fluidity KPI failures through component re-rendering and CPU performance analysis    | <ul><li>`My app's UI fluidity score is low, help me diagnose it`</li><li>`Help me fix frame drops and jank in my Vega app`</li><li>`Why is scrolling not smooth in my app?`</li></ul>                                                                                                                                                |
+| **App Migration**              | Convert FireOS WebView apps to Vega WebView apps while maintaining visual and functional consistency | <ul><li>`Convert my FOS WebView app to a Vega Web App`</li><li>`Help me migrate my FireOS web app at /path/to/fos-app to Vega`</li></ul>                                                                                                                                                                                            |
+| **Appstore IAP Integration**   | Integrate and test Amazon Appstore In-App Purchasing (IAP) SDK in Vega apps                      | <ul><li>`Help me integrate IAP in my Vega app`</li><li>`How do I set up In-App Purchasing for my Vega app?`</li><li>`Help me test IAP in my Vega app`</li></ul>                                                                                                                                                                      |
 | **SDK & CLI**                  | Install/update SDK and efficiently run CLI tools via spec-driven CLI                             | <ul><li>`Install/update SDK from AI agents`</li><li>`Build my app`</li><li>`Run my app on virtual device`</li><li>`Run my app on physical device`</li><li>`Run KPI Visualizer and get performance results`</li></ul>                                                                                                                 |
 
 ## One-Click Installation
@@ -36,10 +40,6 @@ Some of the popular AI Agents support installing MCP servers with a single click
 
 [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=amazon-devices-buildertools-mcp&config=eyJjb21tYW5kIjoibnB4IC15IEBhbWF6b24tZGV2aWNlcy9hbWF6b24tZGV2aWNlcy1idWlsZGVydG9vbHMtbWNwQGxhdGVzdCJ9)
 
-### Install MCP on VSCode
-
-[Add to VSCode](vscode:mcp/install?%7B%22name%22%3A%22amazon-devices-buildertools-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40amazon-devices%2Famazon-devices-buildertools-mcp%40latest%22%5D%7D)
-
 ## Installation with script
 
 Run the following command to **automatically** install Amazon Devices Builder Tools MCP in your AI Agent and add Vega-specific context document to your project to guide AI agents:
@@ -234,7 +234,14 @@ You should see a response that includes the following tools:
 - get_app_hot_functions
 - read_document
 - list_documents
+- search_documentation
+- execute_query
+- get_database_schema
 - read_asset
+- diagnose_crash
+- diagnose_key_input_latency
+- diagnose_ui_fluidity
+- convert_fos_webview_to_vega
 
 ## MCP Tools
 
@@ -318,7 +325,60 @@ or with time window filtering:
 Analyze hot functions in /path/to/trace.json from 5 to 15 seconds with a limit of 20 functions
 ```
 
-### 5. `read_asset`
+### 5. `search_documentation`
+
+Search Vega development documentation using full-text search. Returns document IDs and relevant snippets matching the query. Use `read_document` with the returned ID to get full content.
+
+**Parameters:**
+
+- `query` (required): Search query string to find relevant documents
+- `snippet_tokens` (optional): Maximum tokens in returned snippets (default: 32)
+
+**Example usage:**
+
+```
+Search for documents about "performance optimization"
+```
+
+or with custom snippet length:
+
+```
+Search for "React Native best practices" with 64 token snippets
+```
+
+### 6. `get_database_schema`
+
+Get the schema for the Vega documentation database. Call this before using `execute_query` to understand available tables, columns, and FTS5 syntax.
+
+**Parameters:** None
+
+**Example usage:**
+
+```
+Get the database schema for Vega documentation
+```
+
+### 7. `execute_query`
+
+Execute a SQL query against the Vega documentation database. Use this tool for more complex queries when `search_documentation` is insufficient. Use `get_database_schema` first to understand available tables and FTS5 syntax. The database is read-only.
+
+**Parameters:**
+
+- `sql_query` (required): SQL query to execute against the documentation database
+
+**Example usage:**
+
+```
+Execute query to search for "performance OR optimization" with custom snippets
+```
+
+or with a specific SQL query:
+
+```
+Execute query: SELECT dc.id, snippet(document_content_fts, 0, "<b>", "</b>", "...", 64) FROM document_content_fts JOIN document_content dc ON document_content_fts.rowid = dc.rowid WHERE document_content_fts MATCH "performance OR optimization" ORDER BY rank LIMIT 10
+```
+
+### 8. `read_asset`
 
 Read assets referenced in Vega documentation. Assets are saved to a temporary location and the path is returned. Images can be viewed with 
 `fs_read` and scripts executed with the appropriate interpreter (e.g., `python3`)
@@ -432,3 +492,50 @@ Amazon Devices Builder Tools MCP provides the following pre-defined prompt templ
 ```
 > @diagnose_crash /path/to/crash.acr
 ```
+
+### 7. `diagnose_key_input_latency`
+
+**Description:** Diagnose and resolve key input latency issues in React Native Vega apps through systematic analysis of JS Thread performance, CPU bottlenecks, and input event handling optimization.
+
+**Parameters:**
+
+- `vega_app_package_path` (required, string): Absolute path to the Vega app package root directory
+- `app_process_name` (optional, string): Name of the app process experiencing input latency. If not provided, resolved automatically from manifest.toml.
+- `perfetto_trace_file_path` (optional, string): Absolute path to existing Perfetto trace file (if already captured)
+- `target_component_or_button` (optional, string): Specific button or component name to investigate
+- `latency_threshold_ms` (optional, number): Maximum acceptable input latency in milliseconds. Default is 100.
+
+**Example usage:**
+
+```
+> @diagnose_key_input_latency /path/to/my-vega-app
+```
+
+### 8. `diagnose_ui_fluidity`
+
+**Description:** Diagnose UI fluidity KPI failures in React Native Vega apps through systematic analysis of component re-rendering and CPU performance bottlenecks.
+
+**Parameters:**
+
+- `vega_app_package_path` (required, string): Absolute path to the Vega app package root directory
+
+**Example usage:**
+
+```
+> @diagnose_ui_fluidity /path/to/my-vega-app
+```
+
+### 9. `convert_fos_webview_to_vega`
+
+**Description:** Convert an existing FireOS WebView application to a Vega WebView application while maintaining visual and functional consistency using Vega's WebView component.
+
+**Parameters:**
+
+- `fos_app_workspace_path` (required, string): Path to the FireOS web app source code
+- `vega_app_workspace_path` (required, string): Path where the Vega app should be created
+
+**Example usage:**
+
+```
+> @convert_fos_webview_to_vega /path/to/fos-web-app /path/to/vega-app
+```