@amazon-devices/amazon-devices-buildertools-mcp 0.1.35 → 1.0.1
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 +10 -66
- package/README.md +1 -56
- 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
|
@@ -9,7 +9,7 @@ Amazon Devices Builder Tools for AIは、Fire TV向けのAI搭載開発ツール
|
|
|
9
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,14 +17,14 @@ Amazon Devices Builder Toolsは以下の機能を提供します：
|
|
|
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
|
-
| **メディア再生**
|
|
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
28
|
|
|
29
29
|
## スキル
|
|
30
30
|
|
|
@@ -45,18 +45,10 @@ Amazon Devices Builder Toolsは以下の機能を提供します：
|
|
|
45
45
|
|
|
46
46
|
## はじめに
|
|
47
47
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
> ℹ️ 重要: MCPのワンクリックインストール後でも、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` を実行して、プロジェクトディレクトリに優先AIエージェント用のコンテキストドキュメントをインストールすることが重要です。
|
|
51
|
-
|
|
52
|
-
> ⚠️ **非推奨のお知らせ**: `--init-context` フラグは非推奨であり、将来のバージョンで削除されます。代わりに `init-context` サブコマンドを使用してください。
|
|
48
|
+
以下のコマンドを**Bash/ZSHターミナル**（AIエージェント内ではなく）で実行して、Amazon Devices Builder Tools for AIとお好みのAIエージェント用のコンテキストドキュメントをインストールします。その後、AIエージェントを開いてツールの使用を開始してください。
|
|
53
49
|
|
|
54
50
|
```bash
|
|
55
|
-
# 推奨（新しいサブコマンド）
|
|
56
51
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context
|
|
57
|
-
|
|
58
|
-
# 非推奨（削除予定）
|
|
59
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --init-context
|
|
60
52
|
```
|
|
61
53
|
|
|
62
54
|
このコマンドは**インタラクティブ**モードと**非インタラクティブ**モードの両方をサポートしています：
|
|
@@ -87,8 +79,6 @@ init-context [options]
|
|
|
87
79
|
-h, --help init-contextコマンドのヘルプを表示
|
|
88
80
|
```
|
|
89
81
|
|
|
90
|
-
> ⚠️ **注意**: コマンドラインオプションは `init-context` サブコマンドでのみサポートされています。非推奨の `--init-context` フラグはこれらのオプションをサポートしていません。
|
|
91
|
-
|
|
92
82
|
### 使用例
|
|
93
83
|
|
|
94
84
|
```bash
|
|
@@ -114,14 +104,6 @@ npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context -a ki
|
|
|
114
104
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --help
|
|
115
105
|
```
|
|
116
106
|
|
|
117
|
-
### インタラクティブモードのプロンプト
|
|
118
|
-
|
|
119
|
-
インタラクティブモードで実行すると、以下のガイドが表示されます：
|
|
120
|
-
1. AIエージェントを選択（例：Cursorの場合は「1」、Kiroの場合は「6」、その他/カスタムの場合は「8」）
|
|
121
|
-
2. エージェントのMCP設定ファイルを自動的に更新するにはy/nを入力
|
|
122
|
-
3. デフォルトのコンテキストドキュメントインストールパスを選択するか、カスタムパスを入力
|
|
123
|
-
4. アクションを選択：マージ、更新、またはファイルを保存。続行する前にインストールされたコンテキストドキュメントを確認してください。
|
|
124
|
-
|
|
125
107
|
### 他のAIエージェントでの使用
|
|
126
108
|
|
|
127
109
|
AIエージェントがサポートされているリストにない場合は、**「その他/カスタムエージェント」**を選択してください。これにより以下が提供されます：
|
|
@@ -131,44 +113,6 @@ AIエージェントがサポートされているリストにない場合は、
|
|
|
131
113
|
|
|
132
114
|
> ℹ️ 重要: エージェントのMCP設定からMCPサーバーを起動してください（まだ起動していない場合） - 現在実行中のMCPを確認して、amazon-devices-buildertools-mcpが実行中/接続済みとしてリストされていることを確認してください。
|
|
133
115
|
|
|
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
|
-
|
|
144
|
-
## Amazon Devices Builder Tools MCPを手動で設定
|
|
145
|
-
|
|
146
|
-
Amazon Devices Builder Tools MCPを手動で設定するには、AIエージェントのMCP設定にMCP設定を追加します：
|
|
147
|
-
|
|
148
|
-
```json
|
|
149
|
-
"amazon-devices-buildertools-mcp": {
|
|
150
|
-
"command": "npx",
|
|
151
|
-
"args": ["-y", "@amazon-devices/amazon-devices-buildertools-mcp@latest"],
|
|
152
|
-
"type": "stdio"
|
|
153
|
-
}
|
|
154
|
-
```
|
|
155
|
-
|
|
156
|
-
各エージェントには若干異なる手順がありますが、多くは「mcp.json」（または類似の）ファイルを使用して、この新しいMCPサーバーの特定の設定を追加できます。
|
|
157
|
-
|
|
158
|
-
以下に、いくつかの人気のあるAIエージェントとMCPサーバーのインストール方法へのリンクをリストします。
|
|
159
|
-
|
|
160
|
-
| # | AIエージェント | MCPセットアップ手順リンク |
|
|
161
|
-
| --- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
162
|
-
| 1 | Cursor | [手順](https://cursor.com/docs/context/mcp#using-mcpjson) |
|
|
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」を選択 |
|
|
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) |
|
|
167
|
-
|
|
168
|
-
_エージェントがリストにない場合は、続行する前にMCPをサポートしていることを確認してください。_
|
|
169
|
-
|
|
170
|
-
> ℹ️ 重要: 設定後、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` を実行して、プロジェクトディレクトリに優先AIエージェント用のコンテキストドキュメントをインストールしてください
|
|
171
|
-
|
|
172
116
|
## 使用方法
|
|
173
117
|
|
|
174
118
|
### コマンドラインオプション
|
package/README.md
CHANGED
|
@@ -45,18 +45,10 @@ Skills are modular instruction packages installed to the agent's local skills di
|
|
|
45
45
|
|
|
46
46
|
## Get started
|
|
47
47
|
|
|
48
|
-
Run the following command
|
|
49
|
-
|
|
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.
|
|
51
|
-
|
|
52
|
-
> ⚠️ **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.
|
|
53
49
|
|
|
54
50
|
```bash
|
|
55
|
-
# Recommended (new subcommand)
|
|
56
51
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context
|
|
57
|
-
|
|
58
|
-
# Deprecated (will be removed)
|
|
59
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --init-context
|
|
60
52
|
```
|
|
61
53
|
|
|
62
54
|
This command supports both **interactive** and **non-interactive** modes:
|
|
@@ -88,8 +80,6 @@ Options:
|
|
|
88
80
|
-h, --help Show help for init-context command
|
|
89
81
|
```
|
|
90
82
|
|
|
91
|
-
> ⚠️ **Note**: Command-line options are only supported with the `init-context` subcommand. The deprecated `--init-context` flag does not support these options.
|
|
92
|
-
|
|
93
83
|
### Example Usage
|
|
94
84
|
|
|
95
85
|
```bash
|
|
@@ -115,15 +105,6 @@ npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context -a ki
|
|
|
115
105
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --help
|
|
116
106
|
```
|
|
117
107
|
|
|
118
|
-
### Interactive Mode Prompts
|
|
119
|
-
|
|
120
|
-
When running in interactive mode, you'll be guided through:
|
|
121
|
-
|
|
122
|
-
1. Select your AI agent (e.g., "1" for Cursor, "6" for Kiro, "8" for Other/Custom)
|
|
123
|
-
2. Enter y/n to automatically update Agent's MCP settings file
|
|
124
|
-
3. Choose default context document installation path or enter custom path
|
|
125
|
-
4. Choose action: merge, update or save file. Review the installed context document before proceeding.
|
|
126
|
-
|
|
127
108
|
### Using with Other AI Agents
|
|
128
109
|
|
|
129
110
|
If your AI agent isn't in the supported list, select **"Other/Custom Agent"** which provides:
|
|
@@ -133,42 +114,6 @@ If your AI agent isn't in the supported list, select **"Other/Custom Agent"** wh
|
|
|
133
114
|
|
|
134
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.
|
|
135
116
|
|
|
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
|
-
|
|
146
|
-
## Configure Amazon Devices Builder Tools MCP manually
|
|
147
|
-
|
|
148
|
-
To manually configure the Amazon Devices Builder Tools MCP, add the MCP configuration in your AI Agent's MCP settings:
|
|
149
|
-
|
|
150
|
-
```json
|
|
151
|
-
"amazon-devices-buildertools-mcp": {
|
|
152
|
-
"command": "npx",
|
|
153
|
-
"args": ["-y", "@amazon-devices/amazon-devices-buildertools-mcp@latest"],
|
|
154
|
-
"type": "stdio"
|
|
155
|
-
}
|
|
156
|
-
```
|
|
157
|
-
|
|
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.
|
|
159
|
-
|
|
160
|
-
| # | AI Agent | MCP Setup Instructions Link |
|
|
161
|
-
| --- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
162
|
-
| 1 | Cursor | [Instructions](https://cursor.com/docs/context/mcp#using-mcpjson) |
|
|
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" |
|
|
164
|
-
| 3 | Claude Code | [Instructions](https://code.claude.com/docs/en/mcp#option-3%3A-add-a-local-stdio-server) |
|
|
165
|
-
| 4 | Kiro | [Instructions](https://kiro.dev/docs/mcp/) |
|
|
166
|
-
| 5 | Cline | [Instructions](https://docs.cline.bot/mcp/configuring-mcp-servers) |
|
|
167
|
-
|
|
168
|
-
_If your agent is not listed, please ensure it supports MCP before continuing._
|
|
169
|
-
|
|
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
|
|
171
|
-
|
|
172
117
|
## Usage
|
|
173
118
|
|
|
174
119
|
### Command Line Options
|
|
Binary file
|