@amazon-devices/amazon-devices-buildertools-mcp 0.1.24 → 0.1.29
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 +119 -18
- package/README.md +234 -31
- package/dist/171.startserver +1 -0
- package/dist/assets/vega-developer-context.db +0 -0
- package/dist/startserver +5 -5
- package/package.json +1 -1
package/README.ja.md
CHANGED
|
@@ -21,6 +21,8 @@ Amazon Devices Builder Tools MCPは以下の機能をサポートしています
|
|
|
21
21
|
| **UI開発** | スクリーンショットとデザインモックアップからVegaアプリのUIを作成 | <ul><li>`{image_path}に画像があります。サンプルテンプレートを使用して新しいフォルダを作成し、画像に合わせてサンプルテストアプリを更新して、アプリをビルドして実行できることを確認してください。`</li></ul> |
|
|
22
22
|
| **フォーカス管理** | TVインターフェース用のD-Padナビゲーションとフォーカス管理を実装 | <ul><li>`フォーカス管理を示すために2つのボタンを持つアプリを作成できますか？`</li></ul> |
|
|
23
23
|
| **SDK & CLI** | SDKのインストール/更新と、仕様駆動型CLIを介した効率的なCLIツールの実行 | <ul><li>`AIエージェントからSDKをインストール/更新`</li><li>`アプリをビルド`</li><li>`仮想デバイスでアプリを実行`</li><li>`物理デバイスでアプリを実行`</li><li>`KPI Visualizerを実行してパフォーマンス結果を取得`</li></ul> |
|
|
24
|
+
| **クラッシュ分析** | JavaScript、Native、LMK、ANRクラッシュの自動ACR分析による診断 | <ul><li>`なぜアプリがクラッシュしたのですか？`</li><li>`このACRファイルを分析してください /path/to/crash.acr`</li></ul> |
|
|
25
|
+
| **フィードバックの提供** | MCPの使用体験についてAmazonにフィードバックを提供 | <ul><li>`フィードバックを提供したい`</li><li>`Vega MCPのフィードバックを提供するにはどうすればよいですか？`</li></ul> |
|
|
24
26
|
|
|
25
27
|
## ワンクリックインストール
|
|
26
28
|
|
|
@@ -34,23 +36,26 @@ Amazon Devices Builder Tools MCPは以下の機能をサポートしています
|
|
|
34
36
|
|
|
35
37
|
[](https://cursor.com/en-US/install-mcp?name=amazon-devices-buildertools-mcp&config=eyJjb21tYW5kIjoibnB4IC15IEBhbWF6b24tZGV2aWNlcy9hbWF6b24tZGV2aWNlcy1idWlsZGVydG9vbHMtbWNwQGxhdGVzdCJ9)
|
|
36
38
|
|
|
37
|
-
### VSCodeにMCPをインストール
|
|
38
|
-
|
|
39
|
-
[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)
|
|
40
|
-
|
|
41
39
|
|
|
42
40
|
## スクリプトによるインストール
|
|
43
41
|
|
|
44
42
|
以下のコマンドを実行して、AIエージェントにAmazon Devices Builder Tools MCPを**自動的に**インストールし、AIエージェントをガイドするためのVega固有のコンテキストドキュメントをプロジェクトに追加します：
|
|
45
43
|
|
|
46
|
-
> ℹ️ 重要: MCPのワンクリックインストール後でも、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest
|
|
44
|
+
> ℹ️ 重要: MCPのワンクリックインストール後でも、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` を実行して、プロジェクトディレクトリに優先AIエージェント用のVegaコンテキストドキュメントをインストールすることが重要です。
|
|
45
|
+
|
|
46
|
+
> ⚠️ **非推奨のお知らせ**: `--init-context` フラグは非推奨であり、将来のバージョンで削除されます。代わりに `init-context` サブコマンドを使用してください。
|
|
47
47
|
|
|
48
48
|
```bash
|
|
49
|
+
# 推奨（新しいサブコマンド）
|
|
50
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context
|
|
51
|
+
|
|
52
|
+
# 非推奨（削除予定）
|
|
49
53
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --init-context
|
|
50
54
|
```
|
|
51
55
|
|
|
52
|
-
|
|
56
|
+
このコマンドは**インタラクティブ**モードと**非インタラクティブ**モードの両方をサポートしています：
|
|
53
57
|
|
|
58
|
+
**インタラクティブモード（デフォルト）:**
|
|
54
59
|
1. **利用可能なAIエージェント**とそのコンテキストファイル要件を表示
|
|
55
60
|
2. サポートされているリストから**優先AIエージェントを選択**
|
|
56
61
|
3. Amazon Devices Builder Tools MCPサーバーを設定するために**選択したエージェントのMCP設定を更新**
|
|
@@ -58,21 +63,58 @@ npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --init-context
|
|
|
58
63
|
5. マージまたは更新コンテンツを提供することで**既存のコンテキストファイルを処理**
|
|
59
64
|
6. 選択したAIエージェントの正しい場所に**適切なコンテキストファイルを作成**
|
|
60
65
|
|
|
66
|
+
**非インタラクティブモード:**
|
|
67
|
+
コマンドラインオプションを使用してプロンプトをスキップし、セットアッププロセスを自動化します。
|
|
68
|
+
|
|
69
|
+
### コマンドラインオプション
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
init-context [options]
|
|
73
|
+
|
|
74
|
+
オプション:
|
|
75
|
+
-a, --agent <type> 対象のAIエージェント（cursor、cline、kiro、claude-code-cli、
|
|
76
|
+
claude-code-desktop、github-copilot、amazon-q、other）
|
|
77
|
+
-p, --context-document-path コンテキストドキュメントを保存するパス
|
|
78
|
+
-d, --skip-context-document コンテキストドキュメントのインストールをスキップ（MCP設定のみ）
|
|
79
|
+
-m, --skip-mcp-config MCP設定をスキップ（コンテキストドキュメントのみ）
|
|
80
|
+
-f, --force すべての確認プロンプトをスキップして強制上書き
|
|
81
|
+
-h, --help init-contextコマンドのヘルプを表示
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
> ⚠️ **注意**: コマンドラインオプションは `init-context` サブコマンドでのみサポートされています。非推奨の `--init-context` フラグはこれらのオプションをサポートしていません。
|
|
85
|
+
|
|
61
86
|
### 使用例
|
|
62
87
|
|
|
63
88
|
```bash
|
|
64
89
|
# プロジェクトディレクトリに移動
|
|
65
90
|
cd my-vega-project
|
|
66
91
|
|
|
67
|
-
#
|
|
68
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest
|
|
92
|
+
# インタラクティブモード（デフォルト）
|
|
93
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context
|
|
94
|
+
|
|
95
|
+
# 特定のエージェントで非インタラクティブ
|
|
96
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --agent cursor --force
|
|
97
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context -a cursor -f
|
|
98
|
+
|
|
99
|
+
# MCP設定のみ（コンテキストドキュメントをスキップ）
|
|
100
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --agent cursor --skip-context-document
|
|
101
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context -a cursor -d
|
|
102
|
+
|
|
103
|
+
# カスタムパスでコンテキストドキュメントのみ（MCP設定をスキップ）
|
|
104
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --agent kiro --context-document-path ./docs --skip-mcp-config
|
|
105
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context -a kiro -p ./docs -m
|
|
106
|
+
|
|
107
|
+
# ヘルプを表示
|
|
108
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --help
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### インタラクティブモードのプロンプト
|
|
69
112
|
|
|
70
|
-
|
|
71
|
-
# 1. AIエージェントを選択（例：Kiroの場合は「
|
|
113
|
+
インタラクティブモードで実行すると、以下のガイドが表示されます：
|
|
114
|
+
# 1. AIエージェントを選択（例：Cursorの場合は「1」、Kiroの場合は「6」、その他/カスタムの場合は「8」）
|
|
72
115
|
# 2. エージェントのMCP設定ファイルを自動的に更新するにはy/nを入力
|
|
73
116
|
# 3. デフォルトのコンテキストドキュメントインストールパスを選択するか、カスタムパスを入力
|
|
74
117
|
# 4. アクションを選択：マージ、更新、またはファイルを保存。続行する前にインストールされたコンテキストドキュメントを確認してください。
|
|
75
|
-
```
|
|
76
118
|
|
|
77
119
|
### 他のAIエージェントでの使用
|
|
78
120
|
|
|
@@ -103,28 +145,73 @@ Amazon Devices Builder Tools MCPを手動で設定するには、AIエージェ
|
|
|
103
145
|
| --- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
104
146
|
| 1 | Cursor | [手順](https://cursor.com/docs/context/mcp#using-mcpjson) |
|
|
105
147
|
| 2 | Github Copilot | [手順](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp) 次に「Configuring MCP Servers Manually」を選択 |
|
|
106
|
-
| 3 | Claude Code
|
|
107
|
-
| 4 |
|
|
108
|
-
| 5 | Amazon Q
|
|
109
|
-
| 6 |
|
|
110
|
-
| 7 |
|
|
148
|
+
| 3 | Claude Code | [手順](https://code.claude.com/docs/en/mcp#option-3%3A-add-a-local-stdio-server) |
|
|
149
|
+
| 4 | Claude Code Desktop | [手順](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) |
|
|
150
|
+
| 5 | Amazon Q IDE Extension | [手順](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/mcp-ide.html) |
|
|
151
|
+
| 6 | Amazon Q CLI | [手順](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-config-CLI.html) |
|
|
152
|
+
| 7 | Kiro | [手順](https://kiro.dev/docs/mcp/) |
|
|
153
|
+
| 8 | Cline | [手順](https://docs.cline.bot/mcp/configuring-mcp-servers) |
|
|
111
154
|
|
|
112
155
|
_エージェントがリストにない場合は、続行する前にMCPをサポートしていることを確認してください。_
|
|
113
156
|
|
|
114
|
-
> ℹ️ 重要: 設定後、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest
|
|
157
|
+
> ℹ️ 重要: 設定後、`npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context` を実行して、プロジェクトディレクトリに優先AIエージェント用のVegaコンテキストドキュメントをインストールしてください
|
|
115
158
|
|
|
116
159
|
## 使用方法
|
|
117
160
|
|
|
118
161
|
### コマンドラインオプション
|
|
119
162
|
|
|
120
163
|
```bash
|
|
121
|
-
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest
|
|
164
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context # Amazon Devices Builder Tools MCPをインストールし、AIエージェント用のVegaコンテキストを初期化
|
|
165
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status # AIエージェントのセットアップステータスを確認
|
|
122
166
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --version # バージョン情報を表示
|
|
123
167
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest -v # バージョン情報を表示（エイリアス）
|
|
124
168
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --help # ヘルプメッセージを表示
|
|
125
169
|
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest -h # ヘルプメッセージを表示（エイリアス）
|
|
126
170
|
```
|
|
127
171
|
|
|
172
|
+
### エージェントセットアップステータスの確認
|
|
173
|
+
|
|
174
|
+
MCPサーバーとコンテキストドキュメントをインストールした後、`check-status` コマンドを使用してセットアップを確認できます：
|
|
175
|
+
|
|
176
|
+
```bash
|
|
177
|
+
# すべてのエージェントを確認
|
|
178
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status
|
|
179
|
+
|
|
180
|
+
# 特定のエージェントを確認
|
|
181
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status --agent kiro
|
|
182
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status -a cursor
|
|
183
|
+
|
|
184
|
+
# ヘルプを表示
|
|
185
|
+
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status --help
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
**確認内容:**
|
|
189
|
+
- ✅ コンテキストドキュメントのインストール状態とバージョン
|
|
190
|
+
- ✅ MCP設定の状態
|
|
191
|
+
- ✅ レガシー設定の検出
|
|
192
|
+
- ✅ 全体的なセットアップの概要
|
|
193
|
+
|
|
194
|
+
**出力例:**
|
|
195
|
+
|
|
196
|
+
```
|
|
197
|
+
====================================================
|
|
198
|
+
🔍 Checking Agent Setup Status
|
|
199
|
+
====================================================
|
|
200
|
+
|
|
201
|
+
─────────────────────────────────────────────────────────────────────────────
|
|
202
|
+
Agent │ Context Document │ MCP Configuration
|
|
203
|
+
─────────────────────────────────────────────────────────────────────────────
|
|
204
|
+
Cursor │ ✅ v5.1 │ ✅ Configured
|
|
205
|
+
Kiro │ ✅ v5.1 │ ✅ Configured
|
|
206
|
+
─────────────────────────────────────────────────────────────────────────────
|
|
207
|
+
|
|
208
|
+
📊 Summary:
|
|
209
|
+
Total agents checked: 2
|
|
210
|
+
✅ Fully configured: 2
|
|
211
|
+
⚠️ Partially configured: 0
|
|
212
|
+
❌ Not configured: 0
|
|
213
|
+
```
|
|
214
|
+
|
|
128
215
|
### AIエージェントにAmazon Devices Builder Tools MCPがインストールされていることを確認
|
|
129
216
|
|
|
130
217
|
AIエージェントのチャットインターフェースで、以下のプロンプトを実行します
|
|
@@ -281,3 +368,17 @@ Amazon Devices Builder Tools MCPは、AIエージェントの`/prompts`でワン
|
|
|
281
368
|
```
|
|
282
369
|
> @upgrade_carousel_component /path/to/HomeScreen.tsx 1.0.6 2.0.0
|
|
283
370
|
```
|
|
371
|
+
|
|
372
|
+
### 6. `diagnose_crash`
|
|
373
|
+
|
|
374
|
+
**説明:** JavaScript、Native、LMK（Low Memory Killer）、ANR（Application Not Responding）クラッシュを含むVegaアプリケーションのクラッシュを診断します。ACRファイルを自動検出し、スタックトレースをシンボリケートし、適切な分析ワークフローにルーティングします。
|
|
375
|
+
|
|
376
|
+
**パラメータ:**
|
|
377
|
+
|
|
378
|
+
- `acr_file_path`（任意、文字列）: ACRファイルへのパス。指定しない場合、デバイスの一時ディレクトリからACRファイルを自動検出します。
|
|
379
|
+
|
|
380
|
+
**使用例:**
|
|
381
|
+
|
|
382
|
+
```
|
|
383
|
+
> @diagnose_crash /path/to/crash.acr
|
|
384
|
+
```
|