@amazon-devices/amazon-devices-buildertools-mcp 0.1.34 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +40 -86
- package/README.md +26 -72
- package/dist/assets/vega-developer-context.db +0 -0
- package/dist/startserver +3 -3
- package/package.json +67 -1
- package/LICENSE +0 -7
package/README.ja.md
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
# Amazon Devices Builder Tools
|
|
1
|
+
# Amazon Devices Builder Tools for AI
|
|
2
2
|
|
|
3
3
|
[English](README.md) | **日本語**
|
|
4
4
|
|
|
5
|
-
Model Context Protocol (MCP)
|
|
5
|
+
Amazon Devices Builder Tools for AIは、Fire TV向けのAI搭載開発ツールスイートです。ADBT Model Context Protocol (MCP) サーバーとエージェントスキルを含みます。これらの機能により、Claude、Cursor、Kiroなどのコーディングエージェントが、Fire TVの専門知識とベストプラクティスを認識し、開発やデバッグ作業から推測を排除します。
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Capabilities
|
|
8
8
|
|
|
9
|
-
Amazon Devices Builder Tools
|
|
9
|
+
Amazon Devices Builder Toolsは以下の機能を提供します：
|
|
10
10
|
|
|
11
11
|
| アプリ開発領域 | 説明 | プロンプト例 |
|
|
12
|
-
|--------------|-------------|-----------------|
|
|
12
|
+
|--------------|-------------|-----------------|
|
|
13
13
|
| **オンボーディング** | セットアップガイダンスとQ&Aサポートを使用して、AIエージェントでVegaアプリ開発にオンボード | <ul><li>`Vegaアプリプロジェクトをセットアップして、仮想デバイスでVPKGをテストするのを手伝ってください`</li><li>`Vega SDKのセットアップを手伝ってください`</li><li>`仮想デバイス/接続デバイスでアプリをビルドして実行してください`</li><li>`Vegaアプリ開発について教えてください`</li><li>`VegaデバイスでCPU使用率を測定するためのVega CLIコマンドは何ですか？`</li></ul> |
|
|
14
14
|
| **パフォーマンス** | Time to First Frame (TTFF)、Time to Fully Drawn (TTFD)、およびUI再レンダリングの問題をデバッグして修正 | <ul><li>`なぜ私のVegaアプリのTTFFが高いのですか？`</li><li>`VegaアプリのTime to First Frameの問題をデバッグして修正するのを手伝ってください`</li><li>`なぜ私のVegaアプリのTTFDが高いのですか？`</li><li>`アプリの不要な再レンダリングを最小限に抑えるのを手伝ってください`</li><li>`アプリの再レンダリングの問題を見つけてください`</li></ul> |
|
|
15
15
|
| **パフォーマンスベストプラクティス** | コンポーネントとコードを分析して、React Native Vegaのパフォーマンスベストプラクティスに従っているかを確認 | <ul><li>`このコンポーネントがReact Native Vegaのパフォーマンスベストプラクティスに従っているか分析するのを手伝ってください`</li></ul> |
|
|
@@ -17,43 +17,38 @@ Amazon Devices Builder Tools MCPは以下の機能をサポートしています
|
|
|
17
17
|
| **UI開発** | スクリーンショットとデザインモックアップからVegaアプリのUIを作成 | <ul><li>`{image_path}に画像があります。サンプルテンプレートを使用して新しいフォルダを作成し、画像に合わせてサンプルテストアプリを更新して、アプリをビルドして実行できることを確認してください。`</li></ul> |
|
|
18
18
|
| **フォーカス管理** | TVインターフェース用のD-Padナビゲーションとフォーカス管理を実装 | <ul><li>`フォーカス管理を示すために2つのボタンを持つアプリを作成できますか？`</li></ul> |
|
|
19
19
|
| **SDK & CLI** | SDKのインストール/更新と、仕様駆動型CLIを介した効率的なCLIツールの実行 | <ul><li>`AIエージェントからSDKをインストール/更新`</li><li>`アプリをビルド`</li><li>`仮想デバイスでアプリを実行`</li><li>`物理デバイスでアプリを実行`</li><li>`KPI Visualizerを実行してパフォーマンス結果を取得`</li></ul> |
|
|
20
|
-
| **クラッシュ分析**
|
|
21
|
-
| **キー入力レイテンシー**
|
|
22
|
-
| **UI流暢性**
|
|
23
|
-
| **アプリ移植** *(ベータ)*
|
|
24
|
-
| **Appstore IAP統合**
|
|
25
|
-
| **フィードバックの提供**
|
|
26
|
-
| **リモートナレッジ検索**
|
|
27
|
-
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
> ⚠️ **非推奨のお知らせ**: `--init-context` フラグは非推奨であり、将来のバージョンで削除されます。代わりに `init-context` サブコマンドを使用してください。
|
|
20
|
+
| **クラッシュ分析** | JavaScript、Native、LMK、ANRクラッシュの自動ACR分析による診断 | <ul><li>`なぜアプリがクラッシュしたのですか？`</li><li>`このACRファイルを分析してください /path/to/crash.acr`</li></ul> |
|
|
21
|
+
| **キー入力レイテンシー** | JSスレッドパフォーマンスと入力イベント分析によるキー入力レイテンシーの問題を診断・解決 | <ul><li>`なぜアプリのキー入力が遅いのですか？`</li><li>`Vegaアプリのキー入力レイテンシーを診断してください`</li><li>`ボタンクリックが遅く感じます、助けてください`</li></ul> |
|
|
22
|
+
| **UI流暢性** | コンポーネント再レンダリングとCPUパフォーマンス分析によるUI流暢性KPI障害の診断 | <ul><li>`アプリのUI流暢性スコアが低いです、診断してください`</li><li>`Vegaアプリのフレームドロップとジャンクを修正してください`</li><li>`アプリのスクロールがスムーズでないのはなぜですか？`</li></ul> |
|
|
23
|
+
| **アプリ移植** *(ベータ)* | アプリタイプの自動検出によるFireOSアプリのVegaへの移植、またはWeb URLをVega WebViewアプリとしてラップ。4つの入力パスをサポート：FOS WebView → Vega WebView、FOS React Native → VegaScript、FOS Native (Java/Kotlin) → VegaScript *(部分的サポート)*、Web URL → Vega WebView。 | <ul><li>`TVアプリをVegaに移植してください`</li><li>`/path/to/fos-appにあるFireOSアプリをVegaに移行してください`</li><li>`FOS React NativeアプリをVegaScriptに移植してください`</li><li>`FOS WebViewアプリをVega Webアプリに変換してください`</li><li>`https://example.com をVega WebViewアプリとしてラップしてください`</li></ul> |
|
|
24
|
+
| **Appstore IAP統合** | VegaアプリでAmazon Appstoreアプリ内課金（IAP）SDKを統合・テスト | <ul><li>`VegaアプリにIAPを統合してください`</li><li>`Vegaアプリのアプリ内課金をセットアップするにはどうすればよいですか？`</li><li>`VegaアプリでIAPをテストしてください`</li></ul> |
|
|
25
|
+
| **フィードバックの提供** | MCPの使用体験についてAmazonにフィードバックを提供 | <ul><li>`フィードバックを提供したい`</li><li>`Vega MCPのフィードバックを提供するにはどうすればよいですか？`</li></ul> |
|
|
26
|
+
| **リモートナレッジ検索** | developer.amazon.comおよびcommunity.amazondeveloper.comからドキュメントを検索・取得し、ローカルワークフロー以外のアプリ開発トピックについてもAIアシスタンスを提供 | <ul><li>`Vegaアプリのベータテストはどうすればできますか？`</li><li>`Vegaアプリのアクセシビリティガイドラインは何ですか？`</li><li>`Amazon Appstoreにアプリを提出するにはどうすればよいですか？`</li><li>`VegaのDRMオプションは何がありますか？`</li></ul> |
|
|
27
|
+
| **メディア再生** | W3C MSE/EME APIを使用したアダプティブストリーミング（HLS/DASH）、DRMサポート、Shaka Player統合、ヘッドレス再生アーキテクチャ、メディアコントロールによるVegaアプリへのメディア再生追加 | <ul><li>`/path/to/my-vega-appにあるVegaアプリに https://example.com/stream.m3u8 を使ってシンプルなメディア再生実装を追加してください`</li><li>`Widevineを使用してライセンスURL https://license.example.com でDRM保護された再生をアプリに追加してください`</li><li>`UIスレッドから再生を分離するためにVegaアプリにヘッドレスメディア再生アーキテクチャを実装してください`</li><li>`VegaメディアアプリのShaka Playerをバージョンxからバージョンyにアップデートしてください`</li><li>`メディア再生アプリにキャプションと字幕サポートを追加してください`</li></ul> |
|
|
28
|
+
|
|
29
|
+
## スキル
|
|
30
|
+
|
|
31
|
+
スキルは、`init-context`を通じてエージェントのローカルスキルディレクトリにインストールされるモジュール式の指示パッケージです。MCPラウンドトリップなしで、エージェントがオンデマンドで有効化できるドメイン固有のガイダンスを提供します。
|
|
32
|
+
|
|
33
|
+
| スキル | 説明 |
|
|
34
|
+
|---|---|
|
|
35
|
+
| amazon-devices-vega-app-manifest | パッケージ識別子、機能、権限を含むVegaアプリのmanifest.toml設定 |
|
|
36
|
+
| amazon-devices-vega-app-performance | Vegaアプリケーションのパフォーマンス最適化、KPIターゲット、診断 |
|
|
37
|
+
| amazon-devices-vega-best-practices | Vegaアプリのパフォーマンスガイドライン、開発ワークフロー、アーキテクチャ推奨事項 |
|
|
38
|
+
| amazon-devices-vega-build-and-run | React Native for Vegaアプリケーションのビルド、デプロイ、実行の完全ガイド |
|
|
39
|
+
| amazon-devices-vega-focus-management | TVFocusGuideViewとFocusManagerによるD-Padナビゲーションのカーテシアンフォーカス管理 |
|
|
40
|
+
| amazon-devices-vega-media-player | DRMサポート、アダプティブストリーミング、VideoPlayerコンポーネントによるW3C MSE/EME標準メディア再生 |
|
|
41
|
+
| amazon-devices-vega-navigation | Amazon固有のreact-navigationパッケージを使用したスタック、タブ、ドロワーナビゲーション |
|
|
42
|
+
| amazon-devices-vega-setup-sdk | 前提条件チェックと検証によるVega SDKのインストールと設定 |
|
|
43
|
+
| amazon-devices-vega-ui-components | Carouselなどのネイティブバインディングを持つ高性能Vega UIコンポーネント |
|
|
44
|
+
| vega-multi-tv-migration | Amazon開発者主導のコミュニティスキル：VegaアプリをFire OSを含むクロスデバイスReact Nativeモノレポに移行 |
|
|
45
|
+
|
|
46
|
+
## はじめに
|
|
47
|
+
|
|
48
|
+
以下のコマンドを**Bash/ZSHターミナル**（AIエージェント内ではなく）で実行して、Amazon Devices Builder Tools for AIとお好みのAIエージェント用のコンテキストドキュメントをインストールします。その後、AIエージェントを開いてツールの使用を開始してください。
|
|
50
49
|
|
|
51
50
|
```bash
|
|
52
|
-
# 推奨（新しいサブコマンド）
|
|
53
51
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context
|
|
54
|
-
|
|
55
|
-
# 非推奨（削除予定）
|
|
56
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --init-context
|
|
57
52
|
```
|
|
58
53
|
|
|
59
54
|
このコマンドは**インタラクティブ**モードと**非インタラクティブ**モードの両方をサポートしています：
|
|
@@ -76,7 +71,7 @@ init-context [options]
|
|
|
76
71
|
|
|
77
72
|
オプション:
|
|
78
73
|
-a, --agent <type> 対象のAIエージェント（cursor、cline、kiro、claude-code-cli、
|
|
79
|
-
|
|
74
|
+
github-copilot、other）
|
|
80
75
|
-p, --context-document-path コンテキストドキュメントを保存するパス
|
|
81
76
|
-d, --skip-context-document コンテキストドキュメントのインストールをスキップ（MCP設定のみ）
|
|
82
77
|
-m, --skip-mcp-config MCP設定をスキップ（コンテキストドキュメントのみ）
|
|
@@ -84,8 +79,6 @@ init-context [options]
|
|
|
84
79
|
-h, --help init-contextコマンドのヘルプを表示
|
|
85
80
|
```
|
|
86
81
|
|
|
87
|
-
> ⚠️ **注意**: コマンドラインオプションは `init-context` サブコマンドでのみサポートされています。非推奨の `--init-context` フラグはこれらのオプションをサポートしていません。
|
|
88
|
-
|
|
89
82
|
### 使用例
|
|
90
83
|
|
|
91
84
|
```bash
|
|
@@ -111,14 +104,6 @@ npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context -a ki
|
|
|
111
104
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --help
|
|
112
105
|
```
|
|
113
106
|
|
|
114
|
-
### インタラクティブモードのプロンプト
|
|
115
|
-
|
|
116
|
-
インタラクティブモードで実行すると、以下のガイドが表示されます：
|
|
117
|
-
1. AIエージェントを選択（例：Cursorの場合は「1」、Kiroの場合は「6」、その他/カスタムの場合は「8」）
|
|
118
|
-
2. エージェントのMCP設定ファイルを自動的に更新するにはy/nを入力
|
|
119
|
-
3. デフォルトのコンテキストドキュメントインストールパスを選択するか、カスタムパスを入力
|
|
120
|
-
4. アクションを選択：マージ、更新、またはファイルを保存。続行する前にインストールされたコンテキストドキュメントを確認してください。
|
|
121
|
-
|
|
122
107
|
### 他のAIエージェントでの使用
|
|
123
108
|
|
|
124
109
|
AIエージェントがサポートされているリストにない場合は、**「その他/カスタムエージェント」**を選択してください。これにより以下が提供されます：
|
|
@@ -128,43 +113,12 @@ AIエージェントがサポートされているリストにない場合は、
|
|
|
128
113
|
|
|
129
114
|
> ℹ️ 重要: エージェントのMCP設定からMCPサーバーを起動してください（まだ起動していない場合） - 現在実行中のMCPを確認して、amazon-devices-buildertools-mcpが実行中/接続済みとしてリストされていることを確認してください。
|
|
130
115
|
|
|
131
|
-
## Amazon Devices Builder Tools MCPを手動で設定
|
|
132
|
-
|
|
133
|
-
Amazon Devices Builder Tools MCPを手動で設定するには、AIエージェントのMCP設定にMCP設定を追加します：
|
|
134
|
-
|
|
135
|
-
```json
|
|
136
|
-
"amazon-devices-buildertools-mcp": {
|
|
137
|
-
"command": "npx",
|
|
138
|
-
"args": ["-y", "@amazon-devices/amazon-devices-buildertools-mcp@latest"],
|
|
139
|
-
"type": "stdio"
|
|
140
|
-
}
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
各エージェントには若干異なる手順がありますが、多くは「mcp.json」（または類似の）ファイルを使用して、この新しいMCPサーバーの特定の設定を追加できます。
|
|
144
|
-
|
|
145
|
-
以下に、いくつかの人気のあるAIエージェントとMCPサーバーのインストール方法へのリンクをリストします。
|
|
146
|
-
|
|
147
|
-
| # | AIエージェント | MCPセットアップ手順リンク |
|
|
148
|
-
| --- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
149
|
-
| 1 | Cursor | [手順](https://cursor.com/docs/context/mcp#using-mcpjson) |
|
|
150
|
-
| 2 | Github Copilot | [手順](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp) 次に「Configuring MCP Servers Manually」を選択 |
|
|
151
|
-
| 3 | Claude Code | [手順](https://code.claude.com/docs/en/mcp#option-3%3A-add-a-local-stdio-server) |
|
|
152
|
-
| 4 | Claude Code Desktop | [手順](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) |
|
|
153
|
-
| 5 | Amazon Q IDE Extension | [手順](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/mcp-ide.html) |
|
|
154
|
-
| 6 | Amazon Q CLI | [手順](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-config-CLI.html) |
|
|
155
|
-
| 7 | Kiro | [手順](https://kiro.dev/docs/mcp/) |
|
|
156
|
-
| 8 | Cline | [手順](https://docs.cline.bot/mcp/configuring-mcp-servers) |
|
|
157
|
-
|
|
158
|
-
_エージェントがリストにない場合は、続行する前にMCPをサポートしていることを確認してください。_
|
|
159
|
-
|
|
160
|
-
> ℹ️ 重要: 設定後、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` を実行して、プロジェクトディレクトリに優先AIエージェント用のVegaコンテキストドキュメントをインストールしてください
|
|
161
|
-
|
|
162
116
|
## 使用方法
|
|
163
117
|
|
|
164
118
|
### コマンドラインオプション
|
|
165
119
|
|
|
166
120
|
```bash
|
|
167
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context # Amazon Devices Builder Tools
|
|
121
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context # Amazon Devices Builder Tools for AIをインストールし、AIエージェント用のコンテキストを初期化
|
|
168
122
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status # AIエージェントのセットアップステータスを確認
|
|
169
123
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --version # バージョン情報を表示
|
|
170
124
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest -v # バージョン情報を表示（エイリアス）
|
|
@@ -235,7 +189,7 @@ Amazon Devices Builder Tools MCPが提供するツールをリストしてくだ
|
|
|
235
189
|
|
|
236
190
|
## MCPツール
|
|
237
191
|
|
|
238
|
-
Amazon Devices Builder Tools
|
|
192
|
+
Amazon Devices Builder Tools for AIは、Amazon Devicesアプリ開発を支援するために以下のツールを提供します：
|
|
239
193
|
|
|
240
194
|
### 1. `analyze_perfetto_traces`
|
|
241
195
|
|
|
@@ -278,7 +232,7 @@ CPUトレースファイルを読み取って分析し、パフォーマンス
|
|
|
278
232
|
|
|
279
233
|
### 3. `list_documents`
|
|
280
234
|
|
|
281
|
-
Amazon
|
|
235
|
+
Amazon Devicesアプリ開発に関連する利用可能なすべてのドキュメントをリストします。`read_document`ツールを使用して取得できる利用可能なドキュメントの名前と説明を返します。
|
|
282
236
|
|
|
283
237
|
**パラメータ:**
|
|
284
238
|
- `documentType`（オプション）: タイプでドキュメントをフィルタリング。有効な値：`KB`（ナレッジベース）、`PROMPT`、`STEERING`、`WORKFLOW`
|
|
@@ -294,7 +248,7 @@ Amazon Vega OSのアプリ開発に関連する利用可能なすべてのVega
|
|
|
294
248
|
|
|
295
249
|
### 4. `read_asset`
|
|
296
250
|
|
|
297
|
-
|
|
251
|
+
Amazon Devicesドキュメントで参照されているアセットを読み取ります。アセットは一時的な場所に保存され、パスが返されます。
|
|
298
252
|
|
|
299
253
|
**パラメータ:**
|
|
300
254
|
- `asset_id`（必須）: 読み取るアセットのパス（例：`assets/scripts/example.py`または`assets/images/diagram.png`）
|
|
@@ -306,7 +260,7 @@ assets/scripts/setup.shスクリプトを読み取って実行してください
|
|
|
306
260
|
|
|
307
261
|
### 5. `read_document`
|
|
308
262
|
|
|
309
|
-
Amazon
|
|
263
|
+
Amazon Devicesアプリ開発に関連するドキュメントを読み取ります。このツールは、アプリ開発とデバッグトピックに関する包括的なドキュメントへのアクセスを提供します。
|
|
310
264
|
|
|
311
265
|
**パラメータ:**
|
|
312
266
|
- `document_uri`（必須）: 読み取るドキュメントのURI。ローカルドキュメント名（例：`vega_cli_commands_reference.md`）またはdeveloper.amazon.comのURLを受け付けます。
|
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
# Amazon Devices Builder Tools
|
|
1
|
+
# Amazon Devices Builder Tools for AI
|
|
2
2
|
|
|
3
3
|
**English** | [日本語](README.ja.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Amazon Devices Builder Tools for AI is a suite of AI-powered development tools for Fire TV - including ADBT Model Context Protocol (MCP) Server and Agent skills. These capabilities make your coding agents such as Claude, Cursor, and Kiro aware of specialized Fire TV knowledge and best practices, eliminating guesswork from development and debugging tasks.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Capabilities
|
|
8
8
|
|
|
9
|
-
The Amazon Devices Builder Tools
|
|
9
|
+
The Amazon Devices Builder Tools provides the following capabilities:
|
|
10
10
|
|
|
11
11
|
| App Dev Area | Description | Example Prompts |
|
|
12
12
|
| ------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
@@ -24,35 +24,31 @@ The Amazon Devices Builder Tools MCP supports the following capabilities:
|
|
|
24
24
|
| **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> |
|
|
25
25
|
| **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> |
|
|
26
26
|
| **Remote Knowledge Search** | Search and retrieve documentation from developer.amazon.com and community.amazondeveloper.com to get AI assistance on any documented app development topic beyond curated local workflows | <ul><li>`How can I do a beta test of my Vega app?`</li><li>`What are the accessibility guidelines for Vega apps?`</li><li>`How do I submit my app to the Amazon Appstore?`</li><li>`What DRM options are available for Vega?`</li></ul> |
|
|
27
|
-
| **RN83 Alpha Preview** *(Alpha)* | Guide allowlisted alpha partners through the full RN 0.83 preview lifecycle: private registry setup, preview SDK installation, migration, and cleanup/uninstall steps. | <ul><li>`Help me set up the RN83 alpha preview`</li><li>`How do I install the preview SDK?`</li><li>`How do I uninstall the RN83 preview SDK and clean up?`</li></ul> |
|
|
28
27
|
| **Media Playback** | Add media playback to Vega apps using W3C MSE/EME APIs with adaptive streaming (HLS/DASH), DRM support, Shaka Player integration, headless playback architecture, and media controls | <ul><li>`Add a simple media playback implementation to my Vega app at /path/to/my-vega-app using https://example.com/stream.m3u8`</li><li>`Add DRM-protected playback to my app using Widevine with license URL https://license.example.com`</li><li>`Implement headless media playback architecture in my Vega app to decouple playback from the UI thread`</li><li>`Update Shaka Player from version x to version y in my Vega media playback app`</li><li>`Add captions and subtitle support to my media playback app`</li></ul> |
|
|
29
28
|
|
|
30
|
-
##
|
|
29
|
+
## Skills
|
|
31
30
|
|
|
32
|
-
|
|
31
|
+
Skills are modular instruction packages installed to the agent's local skills directory via `init-context`. They provide domain-specific guidance that agents can activate on demand without MCP round-trips.
|
|
33
32
|
|
|
34
|
-
|
|
33
|
+
| Skill | Description |
|
|
34
|
+
|---|---|
|
|
35
|
+
| amazon-devices-vega-app-manifest | Required manifest.toml configuration for Vega apps including package identifiers, capabilities, and privileges |
|
|
36
|
+
| amazon-devices-vega-app-performance | Performance optimization, KPI targets, and diagnostics for Vega applications |
|
|
37
|
+
| amazon-devices-vega-best-practices | Performance guidelines, development workflow, and architecture recommendations for Vega apps |
|
|
38
|
+
| amazon-devices-vega-build-and-run | Complete guide for building, deploying, and running React Native for Vega applications |
|
|
39
|
+
| amazon-devices-vega-focus-management | Cartesian focus management for D-Pad navigation with TVFocusGuideView and FocusManager |
|
|
40
|
+
| amazon-devices-vega-media-player | W3C MSE/EME standard media playback with DRM support, adaptive streaming, and VideoPlayer component |
|
|
41
|
+
| amazon-devices-vega-navigation | Stack, tab, and drawer navigation using Amazon-specific react-navigation packages |
|
|
42
|
+
| amazon-devices-vega-setup-sdk | Installs and configures the Vega SDK with prerequisite checks and verification |
|
|
43
|
+
| amazon-devices-vega-ui-components | High performance Vega UI Components with native bindings such as Carousel |
|
|
44
|
+
| vega-multi-tv-migration | Amazon developer led community skill to migrate Vega apps to a cross-device React Native monorepo including Fire OS |
|
|
35
45
|
|
|
36
|
-
|
|
46
|
+
## Get started
|
|
37
47
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
[](https://cursor.com/en-US/install-mcp?name=amazon-devices-buildertools-mcp&config=eyJjb21tYW5kIjoibnB4IC15IEBhbWF6b24tZGV2aWNlcy9hbWF6b24tZGV2aWNlcy1idWlsZGVydG9vbHMtbWNwQGxhdGVzdCJ9)
|
|
41
|
-
|
|
42
|
-
## Installation with script
|
|
43
|
-
|
|
44
|
-
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:
|
|
45
|
-
|
|
46
|
-
> ℹ️ Important: It is important to run `npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` to install the Vega-context document for your preferred AI agent in the project directory. This step is required even after one-click install of mcp.
|
|
47
|
-
|
|
48
|
-
> ⚠️ **Deprecation Notice**: The `--init-context` flag is deprecated and will be removed in a future version. Please use the `init-context` subcommand instead.
|
|
48
|
+
Run the following command in your **Bash/ZSH terminal** (not within agent chat window) to install Amazon Devices Builder Tools for AI and the context document for your preferred AI agent. Then start a new chat session in your agent, to begin using the tools.
|
|
49
49
|
|
|
50
50
|
```bash
|
|
51
|
-
# Recommended (new subcommand)
|
|
52
51
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context
|
|
53
|
-
|
|
54
|
-
# Deprecated (will be removed)
|
|
55
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --init-context
|
|
56
52
|
```
|
|
57
53
|
|
|
58
54
|
This command supports both **interactive** and **non-interactive** modes:
|
|
@@ -76,7 +72,7 @@ init-context [options]
|
|
|
76
72
|
|
|
77
73
|
Options:
|
|
78
74
|
-a, --agent <type> Target AI agent (cursor, cline, kiro, claude-code-cli,
|
|
79
|
-
|
|
75
|
+
github-copilot, other)
|
|
80
76
|
-p, --context-document-path Path to save context document
|
|
81
77
|
-d, --skip-context-document Skip context document installation (MCP config only)
|
|
82
78
|
-m, --skip-mcp-config Skip MCP configuration (context document only)
|
|
@@ -84,8 +80,6 @@ Options:
|
|
|
84
80
|
-h, --help Show help for init-context command
|
|
85
81
|
```
|
|
86
82
|
|
|
87
|
-
> ⚠️ **Note**: Command-line options are only supported with the `init-context` subcommand. The deprecated `--init-context` flag does not support these options.
|
|
88
|
-
|
|
89
83
|
### Example Usage
|
|
90
84
|
|
|
91
85
|
```bash
|
|
@@ -111,15 +105,6 @@ npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context -a ki
|
|
|
111
105
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --help
|
|
112
106
|
```
|
|
113
107
|
|
|
114
|
-
### Interactive Mode Prompts
|
|
115
|
-
|
|
116
|
-
When running in interactive mode, you'll be guided through:
|
|
117
|
-
|
|
118
|
-
1. Select your AI agent (e.g., "1" for Cursor, "6" for Kiro, "8" for Other/Custom)
|
|
119
|
-
2. Enter y/n to automatically update Agent's MCP settings file
|
|
120
|
-
3. Choose default context document installation path or enter custom path
|
|
121
|
-
4. Choose action: merge, update or save file. Review the installed context document before proceeding.
|
|
122
|
-
|
|
123
108
|
### Using with Other AI Agents
|
|
124
109
|
|
|
125
110
|
If your AI agent isn't in the supported list, select **"Other/Custom Agent"** which provides:
|
|
@@ -129,43 +114,12 @@ If your AI agent isn't in the supported list, select **"Other/Custom Agent"** wh
|
|
|
129
114
|
|
|
130
115
|
> ℹ️ Important: Start the MCP Server from Agent's MCP config, if not already started - check your current running MCPs to ensure the amazon-devices-buildertools-mcp is listed as running/connected.
|
|
131
116
|
|
|
132
|
-
## Configure Amazon Devices Builder Tools MCP manually
|
|
133
|
-
|
|
134
|
-
To manually configure the Amazon Devices Builder Tools MCP, add the MCP configuration in your AI Agent's MCP settings:
|
|
135
|
-
|
|
136
|
-
```json
|
|
137
|
-
"amazon-devices-buildertools-mcp": {
|
|
138
|
-
"command": "npx",
|
|
139
|
-
"args": ["-y", "@amazon-devices/amazon-devices-buildertools-mcp@latest"],
|
|
140
|
-
"type": "stdio"
|
|
141
|
-
}
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
Each Agent has slightly different instructions, but many involve using an "mcp.json" (or similar) file where you can add the specific configuration for this new MCP server.
|
|
145
|
-
|
|
146
|
-
Below we list some popular AI agents and the link to how to install MCP servers.
|
|
147
|
-
|
|
148
|
-
| # | AI Agent | MCP Setup Instructions Link |
|
|
149
|
-
| --- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
150
|
-
| 1 | Cursor | [Instructions](https://cursor.com/docs/context/mcp#using-mcpjson) |
|
|
151
|
-
| 2 | Github Copilot | [Instructions](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp) then choose "Configuring MCP Servers Manually" |
|
|
152
|
-
| 3 | Claude Code | [Instructions](https://code.claude.com/docs/en/mcp#option-3%3A-add-a-local-stdio-server) |
|
|
153
|
-
| 4 | Claude Code Desktop | [Instructions](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) |
|
|
154
|
-
| 5 | Amazon Q IDE Extension | [Instructions](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/mcp-ide.html) |
|
|
155
|
-
| 6 | Amazon Q CLI | [Instructions](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-config-CLI.html) |
|
|
156
|
-
| 7 | Kiro | [Instructions](https://kiro.dev/docs/mcp/) |
|
|
157
|
-
| 8 | Cline | [Instructions](https://docs.cline.bot/mcp/configuring-mcp-servers) |
|
|
158
|
-
|
|
159
|
-
_If your agent is not listed, please ensure it supports MCP before continuing._
|
|
160
|
-
|
|
161
|
-
> ℹ️ Important: Once configured, run `npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` to install the Vega-context document for your preferred AI agent in the project directory
|
|
162
|
-
|
|
163
117
|
## Usage
|
|
164
118
|
|
|
165
119
|
### Command Line Options
|
|
166
120
|
|
|
167
121
|
```bash
|
|
168
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context # Install Amazon Devices Builder Tools
|
|
122
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context # Install Amazon Devices Builder Tools for AI and initialize context for AI agents
|
|
169
123
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status # Check setup status of AI agents
|
|
170
124
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --version # Show version information
|
|
171
125
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest -v # Show version information (alias)
|
|
@@ -236,7 +190,7 @@ You should see a response that includes the following tools:
|
|
|
236
190
|
|
|
237
191
|
## MCP Tools
|
|
238
192
|
|
|
239
|
-
The Amazon Devices Builder Tools
|
|
193
|
+
The Amazon Devices Builder Tools for AI provides the following tools to assist with Amazon Devices app development:
|
|
240
194
|
|
|
241
195
|
### 1. `analyze_perfetto_traces`
|
|
242
196
|
|
|
@@ -284,7 +238,7 @@ Analyze hot functions in /path/to/trace.json from 5 to 15 seconds with a limit o
|
|
|
284
238
|
|
|
285
239
|
### 3. `list_documents`
|
|
286
240
|
|
|
287
|
-
List all available
|
|
241
|
+
List all available documents related to Amazon Devices app development. Returns name and description of available documents that can be retrieved using the `read_document` tool.
|
|
288
242
|
|
|
289
243
|
**Parameters:**
|
|
290
244
|
|
|
@@ -304,7 +258,7 @@ List documents of type KB
|
|
|
304
258
|
|
|
305
259
|
### 4. `read_asset`
|
|
306
260
|
|
|
307
|
-
Read assets referenced in
|
|
261
|
+
Read assets referenced in Amazon Devices documentation. Assets are saved to a temporary location and the path is returned. Images can be viewed with
|
|
308
262
|
`fs_read` and scripts executed with the appropriate interpreter (e.g., `python3`)
|
|
309
263
|
|
|
310
264
|
**Parameters:**
|
|
@@ -325,7 +279,7 @@ Read the image assets/images/architecture.png and describe what it shows
|
|
|
325
279
|
|
|
326
280
|
### 5. `read_document`
|
|
327
281
|
|
|
328
|
-
Read documents related to
|
|
282
|
+
Read documents related to Amazon Devices app development. This tool provides access to comprehensive documentation about app development and debugging topics.
|
|
329
283
|
|
|
330
284
|
**Parameters:**
|
|
331
285
|
|
|
Binary file
|