@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 CHANGED
@@ -1,12 +1,12 @@
1
- # Amazon Devices Builder Tools MCP サーバー
1
+ # Amazon Devices Builder Tools for AI
2
2
 
3
3
  [English](README.md) | **日本語**
4
4
 
5
- Model Context Protocol (MCP) サーバーで、AIエージェントがAmazonの[Vega OS](https://developer.amazon.com/apps-and-games/vega)向けアプリの開発とデバッグを行うためのコンテキストとツールを提供します。
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 MCPは以下の機能をサポートしています:
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
- 一部の人気のあるAIエージェントは、ワンクリックでMCPサーバーをインストールすることをサポートしています。以下は利用可能なワンクリックインストールオプションです。
31
-
32
- ### KiroにMCPをインストール
31
+ スキルは、`init-context`を通じてエージェントのローカルスキルディレクトリにインストールされるモジュール式の指示パッケージです。MCPラウンドトリップなしで、エージェントがオンデマンドで有効化できるドメイン固有のガイダンスを提供します。
33
32
 
34
- [![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](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)
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
- ### CursorにMCPをインストール
37
-
38
- [![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)
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
- claude-code-desktop、github-copilot、amazon-q、other)
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
+ [![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](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
+ [![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)
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 | [手順](https://code.claude.com/docs/en/mcp#option-3%3A-add-a-local-stdio-server) |
150
- | 4 | Claude Code Desktop | [手順](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) |
151
- | 5 | Amazon Q IDE Extension | [手順](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/mcp-ide.html) |
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エージェント用のVegaコンテキストドキュメントをインストールしてください
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 MCPをインストールし、AIエージェント用のVegaコンテキストを初期化
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 MCPは、Vegaアプリ開発を支援するために以下のツールを提供します:
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 Vega OSのアプリ開発に関連する利用可能なすべてのVegaドキュメントをリストします。`read_document`ツールを使用して取得できる利用可能なドキュメントの名前と説明を返します。
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
- Vegaドキュメントで参照されているアセットを読み取ります。アセットは一時的な場所に保存され、パスが返されます。
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 Vega OSのアプリ開発に関連するドキュメントを読み取ります。このツールは、Vegaアプリ開発とデバッグトピックに関する包括的なドキュメントへのアクセスを提供します。
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 MCP Server
1
+ # Amazon Devices Builder Tools for AI
2
2
 
3
3
  **English** | [日本語](README.ja.md)
4
4
 
5
- A Model Context Protocol (MCP) server that provides context and tools for AI agents to develop and debug apps for Amazon's [Vega OS](https://developer.amazon.com/apps-and-games/vega).
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
- ## Features
7
+ ## Capabilities
8
8
 
9
- The Amazon Devices Builder Tools MCP supports the following capabilities:
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
- ## One-Click Installation
29
+ ## Skills
29
30
 
30
- Some of the popular AI Agents support installing MCP servers with a single click. Below are the one-click install options available.
31
-
32
- ### Install MCP on Kiro
33
-
34
- [![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](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
- [![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)
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
- ## Installation with script
46
+ ## Get started
41
47
 
42
- 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:
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 Vega-context document for your preferred AI agent in the project directory. This step is required even after one-click install of mcp.
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
- claude-code-desktop, github-copilot, amazon-q, other)
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
+ [![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](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
+ [![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)
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 | Claude Code Desktop | [Instructions](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) |
152
- | 5 | Amazon Q IDE Extension | [Instructions](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/mcp-ide.html) |
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 Vega-context document for your preferred AI agent in the project directory
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 MCP and initialize Vega context for AI agents
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 MCP provides the following tools to assist with Vega app development:
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 Vega documents related to App development for Amazon Vega OS. Returns name and description of available documents that can be retrieved using the `read_document` tool.
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 Vega documentation. Assets are saved to a temporary location and the path is returned. Images can be viewed with
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 App development for Amazon Vega OS. This tool provides access to comprehensive documentation about Vega app development and debugging topics.
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
+ ```