@amazon-devices/amazon-devices-buildertools-mcp 0.1.33 → 0.1.35
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 +53 -30
- package/README.md +53 -30
- package/dist/assets/vega-developer-context.db +0 -0
- package/dist/startserver +3 -3
- package/package.json +1 -1
package/README.ja.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
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
|
|--------------|-------------|-----------------|
|
|
@@ -24,25 +24,30 @@ Amazon Devices Builder Tools MCPは以下の機能をサポートしています
|
|
|
24
24
|
| **Appstore IAP統合** | VegaアプリでAmazon Appstoreアプリ内課金(IAP)SDKを統合・テスト | <ul><li>`VegaアプリにIAPを統合してください`</li><li>`Vegaアプリのアプリ内課金をセットアップするにはどうすればよいですか?`</li><li>`VegaアプリでIAPをテストしてください`</li></ul> |
|
|
25
25
|
| **フィードバックの提供** | MCPの使用体験についてAmazonにフィードバックを提供 | <ul><li>`フィードバックを提供したい`</li><li>`Vega MCPのフィードバックを提供するにはどうすればよいですか?`</li></ul> |
|
|
26
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> |
|
|
27
28
|
|
|
28
|
-
##
|
|
29
|
+
## スキル
|
|
29
30
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
### KiroにMCPをインストール
|
|
31
|
+
スキルは、`init-context`を通じてエージェントのローカルスキルディレクトリにインストールされるモジュール式の指示パッケージです。MCPラウンドトリップなしで、エージェントがオンデマンドで有効化できるドメイン固有のガイダンスを提供します。
|
|
33
32
|
|
|
34
|
-
|
|
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モノレポに移行 |
|
|
35
45
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
[](https://cursor.com/en-US/install-mcp?name=amazon-devices-buildertools-mcp&config=eyJjb21tYW5kIjoibnB4IC15IEBhbWF6b24tZGV2aWNlcy9hbWF6b24tZGV2aWNlcy1idWlsZGVydG9vbHMtbWNwQGxhdGVzdCJ9)
|
|
46
|
+
## はじめに
|
|
39
47
|
|
|
48
|
+
以下のコマンドを実行して、AIエージェントにAmazon Devices Builder Tools for AIを**自動的に**インストールし、お好みのAIエージェント用のコンテキストドキュメントをインストールします:
|
|
40
49
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
以下のコマンドを実行して、AIエージェントにAmazon Devices Builder Tools MCPを**自動的に**インストールし、AIエージェントをガイドするためのVega固有のコンテキストドキュメントをプロジェクトに追加します:
|
|
44
|
-
|
|
45
|
-
> ℹ️ 重要: MCPのワンクリックインストール後でも、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` を実行して、プロジェクトディレクトリに優先AIエージェント用のVegaコンテキストドキュメントをインストールすることが重要です。
|
|
50
|
+
> ℹ️ 重要: MCPのワンクリックインストール後でも、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` を実行して、プロジェクトディレクトリに優先AIエージェント用のコンテキストドキュメントをインストールすることが重要です。
|
|
46
51
|
|
|
47
52
|
> ⚠️ **非推奨のお知らせ**: `--init-context` フラグは非推奨であり、将来のバージョンで削除されます。代わりに `init-context` サブコマンドを使用してください。
|
|
48
53
|
|
|
@@ -74,7 +79,7 @@ init-context [options]
|
|
|
74
79
|
|
|
75
80
|
オプション:
|
|
76
81
|
-a, --agent <type> 対象のAIエージェント(cursor、cline、kiro、claude-code-cli、
|
|
77
|
-
|
|
82
|
+
github-copilot、other)
|
|
78
83
|
-p, --context-document-path コンテキストドキュメントを保存するパス
|
|
79
84
|
-d, --skip-context-document コンテキストドキュメントのインストールをスキップ(MCP設定のみ)
|
|
80
85
|
-m, --skip-mcp-config MCP設定をスキップ(コンテキストドキュメントのみ)
|
|
@@ -126,6 +131,16 @@ AIエージェントがサポートされているリストにない場合は、
|
|
|
126
131
|
|
|
127
132
|
> ℹ️ 重要: エージェントのMCP設定からMCPサーバーを起動してください(まだ起動していない場合) - 現在実行中のMCPを確認して、amazon-devices-buildertools-mcpが実行中/接続済みとしてリストされていることを確認してください。
|
|
128
133
|
|
|
134
|
+
一部の人気のあるAIエージェントは、ワンクリックでMCPサーバーをインストールすることをサポートしています。以下は利用可能なワンクリックインストールオプションです。
|
|
135
|
+
|
|
136
|
+
### KiroにMCPをインストール
|
|
137
|
+
|
|
138
|
+
[](https://kiro.dev/launch/mcp/add?name=amazon-devices-buildertools-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40amazon-devices%2Famazon-devices-buildertools-mcp%40latest%22%5D%2C%22disabled%22%3Afalse%7D)
|
|
139
|
+
|
|
140
|
+
### CursorにMCPをインストール
|
|
141
|
+
|
|
142
|
+
[](https://cursor.com/en-US/install-mcp?name=amazon-devices-buildertools-mcp&config=eyJjb21tYW5kIjoibnB4IC15IEBhbWF6b24tZGV2aWNlcy9hbWF6b24tZGV2aWNlcy1idWlsZGVydG9vbHMtbWNwQGxhdGVzdCJ9)
|
|
143
|
+
|
|
129
144
|
## Amazon Devices Builder Tools MCPを手動で設定
|
|
130
145
|
|
|
131
146
|
Amazon Devices Builder Tools MCPを手動で設定するには、AIエージェントのMCP設定にMCP設定を追加します:
|
|
@@ -146,23 +161,20 @@ Amazon Devices Builder Tools MCPを手動で設定するには、AIエージェ
|
|
|
146
161
|
| --- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
147
162
|
| 1 | Cursor | [手順](https://cursor.com/docs/context/mcp#using-mcpjson) |
|
|
148
163
|
| 2 | Github Copilot | [手順](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp) 次に「Configuring MCP Servers Manually」を選択 |
|
|
149
|
-
| 3 | Claude Code
|
|
150
|
-
| 4 |
|
|
151
|
-
| 5 |
|
|
152
|
-
| 6 | Amazon Q CLI | [手順](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-config-CLI.html) |
|
|
153
|
-
| 7 | Kiro | [手順](https://kiro.dev/docs/mcp/) |
|
|
154
|
-
| 8 | Cline | [手順](https://docs.cline.bot/mcp/configuring-mcp-servers) |
|
|
164
|
+
| 3 | Claude Code | [手順](https://code.claude.com/docs/en/mcp#option-3%3A-add-a-local-stdio-server) |
|
|
165
|
+
| 4 | Kiro | [手順](https://kiro.dev/docs/mcp/) |
|
|
166
|
+
| 5 | Cline | [手順](https://docs.cline.bot/mcp/configuring-mcp-servers) |
|
|
155
167
|
|
|
156
168
|
_エージェントがリストにない場合は、続行する前にMCPをサポートしていることを確認してください。_
|
|
157
169
|
|
|
158
|
-
> ℹ️ 重要: 設定後、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` を実行して、プロジェクトディレクトリに優先AI
|
|
170
|
+
> ℹ️ 重要: 設定後、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` を実行して、プロジェクトディレクトリに優先AIエージェント用のコンテキストドキュメントをインストールしてください
|
|
159
171
|
|
|
160
172
|
## 使用方法
|
|
161
173
|
|
|
162
174
|
### コマンドラインオプション
|
|
163
175
|
|
|
164
176
|
```bash
|
|
165
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context # Amazon Devices Builder Tools
|
|
177
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context # Amazon Devices Builder Tools for AIをインストールし、AIエージェント用のコンテキストを初期化
|
|
166
178
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status # AIエージェントのセットアップステータスを確認
|
|
167
179
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --version # バージョン情報を表示
|
|
168
180
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest -v # バージョン情報を表示(エイリアス)
|
|
@@ -233,7 +245,7 @@ Amazon Devices Builder Tools MCPが提供するツールをリストしてくだ
|
|
|
233
245
|
|
|
234
246
|
## MCPツール
|
|
235
247
|
|
|
236
|
-
Amazon Devices Builder Tools
|
|
248
|
+
Amazon Devices Builder Tools for AIは、Amazon Devicesアプリ開発を支援するために以下のツールを提供します:
|
|
237
249
|
|
|
238
250
|
### 1. `analyze_perfetto_traces`
|
|
239
251
|
|
|
@@ -276,7 +288,7 @@ CPUトレースファイルを読み取って分析し、パフォーマンス
|
|
|
276
288
|
|
|
277
289
|
### 3. `list_documents`
|
|
278
290
|
|
|
279
|
-
Amazon
|
|
291
|
+
Amazon Devicesアプリ開発に関連する利用可能なすべてのドキュメントをリストします。`read_document`ツールを使用して取得できる利用可能なドキュメントの名前と説明を返します。
|
|
280
292
|
|
|
281
293
|
**パラメータ:**
|
|
282
294
|
- `documentType`(オプション): タイプでドキュメントをフィルタリング。有効な値:`KB`(ナレッジベース)、`PROMPT`、`STEERING`、`WORKFLOW`
|
|
@@ -292,7 +304,7 @@ Amazon Vega OSのアプリ開発に関連する利用可能なすべてのVega
|
|
|
292
304
|
|
|
293
305
|
### 4. `read_asset`
|
|
294
306
|
|
|
295
|
-
|
|
307
|
+
Amazon Devicesドキュメントで参照されているアセットを読み取ります。アセットは一時的な場所に保存され、パスが返されます。
|
|
296
308
|
|
|
297
309
|
**パラメータ:**
|
|
298
310
|
- `asset_id`(必須): 読み取るアセットのパス(例:`assets/scripts/example.py`または`assets/images/diagram.png`)
|
|
@@ -304,7 +316,7 @@ assets/scripts/setup.shスクリプトを読み取って実行してください
|
|
|
304
316
|
|
|
305
317
|
### 5. `read_document`
|
|
306
318
|
|
|
307
|
-
Amazon
|
|
319
|
+
Amazon Devicesアプリ開発に関連するドキュメントを読み取ります。このツールは、アプリ開発とデバッグトピックに関する包括的なドキュメントへのアクセスを提供します。
|
|
308
320
|
|
|
309
321
|
**パラメータ:**
|
|
310
322
|
- `document_uri`(必須): 読み取るドキュメントのURI。ローカルドキュメント名(例:`vega_cli_commands_reference.md`)またはdeveloper.amazon.comのURLを受け付けます。
|
|
@@ -475,3 +487,14 @@ Amazon Devices Builder Tools MCPは、AIエージェントの`/prompts`でワン
|
|
|
475
487
|
```
|
|
476
488
|
> @upgrade_carousel_component /path/to/HomeScreen.tsx 1.0.6 2.0.0
|
|
477
489
|
```
|
|
490
|
+
|
|
491
|
+
### 11. `react_native_for_vega_rn83_alpha_preview`
|
|
492
|
+
|
|
493
|
+
**説明:** バンドルされた知識ベースを使用して、アローリストされたアルファパートナーをRN 0.83プレビューの全ライフサイクルを通じてガイドします。プライベートレジストリの設定、プレビューSDKのインストール、移行、クリーンアップ/アンインストール手順をカバーします。
|
|
494
|
+
|
|
495
|
+
**パラメータ:** なし
|
|
496
|
+
|
|
497
|
+
**使用例:**
|
|
498
|
+
```
|
|
499
|
+
> @react_native_for_vega_rn83_alpha_preview
|
|
500
|
+
```
|
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,24 +24,30 @@ 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
|
+
| **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> |
|
|
27
28
|
|
|
28
|
-
##
|
|
29
|
+
## Skills
|
|
29
30
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
### Install MCP on Kiro
|
|
33
|
-
|
|
34
|
-
[](https://kiro.dev/launch/mcp/add?name=amazon-devices-buildertools-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40amazon-devices%2Famazon-devices-buildertools-mcp%40latest%22%5D%2C%22disabled%22%3Afalse%7D)
|
|
35
|
-
|
|
36
|
-
### Install MCP on Cursor
|
|
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.
|
|
37
32
|
|
|
38
|
-
|
|
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 |
|
|
39
45
|
|
|
40
|
-
##
|
|
46
|
+
## Get started
|
|
41
47
|
|
|
42
|
-
Run the following command to **automatically** install Amazon Devices Builder Tools
|
|
48
|
+
Run the following command to **automatically** install Amazon Devices Builder Tools for AI in your AI Agent and install the context document for your preferred AI agent:
|
|
43
49
|
|
|
44
|
-
> ℹ️ Important: It is important to run `npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` to install the
|
|
50
|
+
> ℹ️ Important: It is important to run `npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` to install the context document for your preferred AI agent in the project directory. This step is required even after one-click install of mcp.
|
|
45
51
|
|
|
46
52
|
> ⚠️ **Deprecation Notice**: The `--init-context` flag is deprecated and will be removed in a future version. Please use the `init-context` subcommand instead.
|
|
47
53
|
|
|
@@ -74,7 +80,7 @@ init-context [options]
|
|
|
74
80
|
|
|
75
81
|
Options:
|
|
76
82
|
-a, --agent <type> Target AI agent (cursor, cline, kiro, claude-code-cli,
|
|
77
|
-
|
|
83
|
+
github-copilot, other)
|
|
78
84
|
-p, --context-document-path Path to save context document
|
|
79
85
|
-d, --skip-context-document Skip context document installation (MCP config only)
|
|
80
86
|
-m, --skip-mcp-config Skip MCP configuration (context document only)
|
|
@@ -127,6 +133,16 @@ If your AI agent isn't in the supported list, select **"Other/Custom Agent"** wh
|
|
|
127
133
|
|
|
128
134
|
> ℹ️ 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.
|
|
129
135
|
|
|
136
|
+
Some of the popular AI Agents support installing MCP servers with a single click. Below are the one-click install options available.
|
|
137
|
+
|
|
138
|
+
### Install MCP on Kiro
|
|
139
|
+
|
|
140
|
+
[](https://kiro.dev/launch/mcp/add?name=amazon-devices-buildertools-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40amazon-devices%2Famazon-devices-buildertools-mcp%40latest%22%5D%2C%22disabled%22%3Afalse%7D)
|
|
141
|
+
|
|
142
|
+
### Install MCP on Cursor
|
|
143
|
+
|
|
144
|
+
[](https://cursor.com/en-US/install-mcp?name=amazon-devices-buildertools-mcp&config=eyJjb21tYW5kIjoibnB4IC15IEBhbWF6b24tZGV2aWNlcy9hbWF6b24tZGV2aWNlcy1idWlsZGVydG9vbHMtbWNwQGxhdGVzdCJ9)
|
|
145
|
+
|
|
130
146
|
## Configure Amazon Devices Builder Tools MCP manually
|
|
131
147
|
|
|
132
148
|
To manually configure the Amazon Devices Builder Tools MCP, add the MCP configuration in your AI Agent's MCP settings:
|
|
@@ -141,29 +157,24 @@ To manually configure the Amazon Devices Builder Tools MCP, add the MCP configur
|
|
|
141
157
|
|
|
142
158
|
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.
|
|
143
159
|
|
|
144
|
-
Below we list some popular AI agents and the link to how to install MCP servers.
|
|
145
|
-
|
|
146
160
|
| # | AI Agent | MCP Setup Instructions Link |
|
|
147
161
|
| --- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
148
162
|
| 1 | Cursor | [Instructions](https://cursor.com/docs/context/mcp#using-mcpjson) |
|
|
149
163
|
| 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" |
|
|
150
164
|
| 3 | Claude Code | [Instructions](https://code.claude.com/docs/en/mcp#option-3%3A-add-a-local-stdio-server) |
|
|
151
|
-
| 4 |
|
|
152
|
-
| 5 |
|
|
153
|
-
| 6 | Amazon Q CLI | [Instructions](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-config-CLI.html) |
|
|
154
|
-
| 7 | Kiro | [Instructions](https://kiro.dev/docs/mcp/) |
|
|
155
|
-
| 8 | Cline | [Instructions](https://docs.cline.bot/mcp/configuring-mcp-servers) |
|
|
165
|
+
| 4 | Kiro | [Instructions](https://kiro.dev/docs/mcp/) |
|
|
166
|
+
| 5 | Cline | [Instructions](https://docs.cline.bot/mcp/configuring-mcp-servers) |
|
|
156
167
|
|
|
157
168
|
_If your agent is not listed, please ensure it supports MCP before continuing._
|
|
158
169
|
|
|
159
|
-
> ℹ️ Important: Once configured, run `npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` to install the
|
|
170
|
+
> ℹ️ Important: Once configured, run `npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` to install the context document for your preferred AI agent in the project directory
|
|
160
171
|
|
|
161
172
|
## Usage
|
|
162
173
|
|
|
163
174
|
### Command Line Options
|
|
164
175
|
|
|
165
176
|
```bash
|
|
166
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context # Install Amazon Devices Builder Tools
|
|
177
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context # Install Amazon Devices Builder Tools for AI and initialize context for AI agents
|
|
167
178
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status # Check setup status of AI agents
|
|
168
179
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --version # Show version information
|
|
169
180
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest -v # Show version information (alias)
|
|
@@ -234,7 +245,7 @@ You should see a response that includes the following tools:
|
|
|
234
245
|
|
|
235
246
|
## MCP Tools
|
|
236
247
|
|
|
237
|
-
The Amazon Devices Builder Tools
|
|
248
|
+
The Amazon Devices Builder Tools for AI provides the following tools to assist with Amazon Devices app development:
|
|
238
249
|
|
|
239
250
|
### 1. `analyze_perfetto_traces`
|
|
240
251
|
|
|
@@ -282,7 +293,7 @@ Analyze hot functions in /path/to/trace.json from 5 to 15 seconds with a limit o
|
|
|
282
293
|
|
|
283
294
|
### 3. `list_documents`
|
|
284
295
|
|
|
285
|
-
List all available
|
|
296
|
+
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.
|
|
286
297
|
|
|
287
298
|
**Parameters:**
|
|
288
299
|
|
|
@@ -302,7 +313,7 @@ List documents of type KB
|
|
|
302
313
|
|
|
303
314
|
### 4. `read_asset`
|
|
304
315
|
|
|
305
|
-
Read assets referenced in
|
|
316
|
+
Read assets referenced in Amazon Devices documentation. Assets are saved to a temporary location and the path is returned. Images can be viewed with
|
|
306
317
|
`fs_read` and scripts executed with the appropriate interpreter (e.g., `python3`)
|
|
307
318
|
|
|
308
319
|
**Parameters:**
|
|
@@ -323,7 +334,7 @@ Read the image assets/images/architecture.png and describe what it shows
|
|
|
323
334
|
|
|
324
335
|
### 5. `read_document`
|
|
325
336
|
|
|
326
|
-
Read documents related to
|
|
337
|
+
Read documents related to Amazon Devices app development. This tool provides access to comprehensive documentation about app development and debugging topics.
|
|
327
338
|
|
|
328
339
|
**Parameters:**
|
|
329
340
|
|
|
@@ -520,3 +531,15 @@ Amazon Devices Builder Tools MCP provides the following pre-defined prompt templ
|
|
|
520
531
|
```
|
|
521
532
|
> @upgrade_carousel_component /path/to/HomeScreen.tsx 1.0.6 2.0.0
|
|
522
533
|
```
|
|
534
|
+
|
|
535
|
+
### 11. `react_native_for_vega_rn83_alpha_preview`
|
|
536
|
+
|
|
537
|
+
**Description:** Guide allowlisted alpha partners through the full RN 0.83 preview lifecycle using the bundled knowledge base. Covers private registry configuration, preview SDK installation, migration, and cleanup/uninstall steps.
|
|
538
|
+
|
|
539
|
+
**Parameters:** None
|
|
540
|
+
|
|
541
|
+
**Example usage:**
|
|
542
|
+
|
|
543
|
+
```
|
|
544
|
+
> @react_native_for_vega_rn83_alpha_preview
|
|
545
|
+
```
|
|
Binary file
|