bitbank-lab-mcp 0.5.0 → 0.5.2

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.
Files changed (2) hide show
  1. package/README.md +10 -7
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -115,7 +115,9 @@ nvm/volta などのバージョン管理ツールをお使いの方には特に
115
115
 
116
116
  **C. 取引注文・注文キャンセル実行(要 API キー):**
117
117
 
118
- B に加えて、対応ホスト上での発注・注文キャンセルまで実行。実行前に必ず確認ステップ(preview → ユーザーの明示確認)が入ります。
118
+ B に加えて、発注・注文キャンセルまで実行。実行前に必ず確認ステップ(preview → ユーザーの明示確認)が入ります。
119
+
120
+ Claude Desktop では確認カードのボタンから実行するため、B の設定に **`BITBANK_MCP_APPS_EXECUTE=1` を追加**してオプトインします(**既定は無効**。設定する前に下の「⚠️ `BITBANK_MCP_APPS_EXECUTE=1` を設定する前に読んでください」を確認してください)。
119
121
 
120
122
  ```json
121
123
  {
@@ -125,7 +127,8 @@ B に加えて、対応ホスト上での発注・注文キャンセルまで実
125
127
  "args": ["-y", "bitbank-lab-mcp"],
126
128
  "env": {
127
129
  "BITBANK_API_KEY": "your_api_key",
128
- "BITBANK_API_SECRET": "your_api_secret"
130
+ "BITBANK_API_SECRET": "your_api_secret",
131
+ "BITBANK_MCP_APPS_EXECUTE": "1"
129
132
  }
130
133
  }
131
134
  }
@@ -136,7 +139,7 @@ B に加えて、対応ホスト上での発注・注文キャンセルまで実
136
139
  >
137
140
  > ※ **「出金」権限は有効化しないことを強く推奨します**。本サーバーは出金系ツール未実装のため不要です。
138
141
 
139
- 発注・取消の実行には**ユーザーの明示確認が必須**です。確認トークンは `content` / `structuredContent` に載らないため、LLM が preview 応答から直接 execute することはできません。旧 `BITBANK_TRUST_HOST_APPROVAL` オプトイン(iframe に token を `structuredContent` で載せる妥協モード)はセキュリティ上撤去済みで、設定しても無視されます。
142
+ 発注・取消の実行には**ユーザーの明示確認が必須**です。確認トークンは `content` / `structuredContent` には載りません。`BITBANK_MCP_APPS_EXECUTE=1` を設定し、かつクライアントが elicitation 非対応で MCP Apps UI を宣言している場合(Claude Desktop 等)に限り、確認カードに渡すためツール結果の `_meta` に載ります。この場合の安全性は「ホストが `_meta` を LLM に渡さない」ことに依存し、仕様上の保証はありません(下の「⚠️ `BITBANK_MCP_APPS_EXECUTE=1` を設定する前に読んでください」)。
140
143
 
141
144
  確認の経路はクライアントによって変わります。
142
145
 
@@ -266,7 +269,7 @@ Claude Desktop の UI に表示される名前は `claude_desktop_config.json`
266
269
  }
267
270
  ```
268
271
 
269
- API キーが不要な場合は `env` ブロックごと削除して OK。セクション 1 の A〜C と同様に、取引実行まで使う場合は確認フローに対応したクライアントが必要です(旧 `BITBANK_TRUST_HOST_APPROVAL` は不要・無効です)。
272
+ API キーが不要な場合は `env` ブロックごと削除して OK。セクション 1 の A〜C と同様に、取引実行まで使う場合は確認フローに対応したクライアントが必要です。
270
273
 
271
274
  #### Claude Code(CLI から登録する場合)
272
275
 
@@ -282,15 +285,15 @@ Cursor と同じ JSON 形式で登録できます。クライアント固有の
282
285
 
283
286
  ### 3. (オプション)Plugin として install(同梱 Skill を使う)
284
287
 
285
- 通常の利用はセクション 1〜2 の登録だけで完結します。Plugin install は、**Claude Code などの AI コーディングツールで、MCP サーバーに加えて同梱 Skill(`skills/` 配下)も使いたい方向け**のオプションです。
288
+ 通常の利用はセクション 1〜2 の登録だけで完結します。Plugin install は、**Claude Code などの AI コーディングツールで、MCP サーバーに加えて同梱 Skill(`plugins/bitbank-lab-mcp/skills/` 配下)も使いたい方向け**のオプションです。
286
289
 
287
290
  - Plugin として install すると、MCP ツールと同時に同梱 Skill(例: `investment-onboarding`)が有効化されます。今後 Skill を追加した場合も、plugin のアップデートでまとめて届きます。
288
- - Skill を自作してワークフローをカスタマイズしたい方は、[`skills/INDEX.md`](skills/INDEX.md) の構成が参考になります。
291
+ - Skill を自作してワークフローをカスタマイズしたい方は、[`plugins/bitbank-lab-mcp/skills/INDEX.md`](plugins/bitbank-lab-mcp/skills/INDEX.md) の構成が参考になります。
289
292
  - **Claude Desktop は plugin / Skill の読み込みに未対応**です。Claude Desktop で使う場合は[セクション 1](#1-claude-desktop-に登録推奨) の方法で登録してください(MCP ツールの機能は同じで、Skill が使えるかどうかだけの違いです)。
290
293
 
291
294
  | クライアント | manifest | API キーの渡し方 |
292
295
  |---|---|---|
293
- | Claude Code | `.claude-plugin/plugin.json` | ✅ **GUI で入力**: `/plugin install` 直後に `userConfig` UI が表示され、OS キーチェーンに保管 |
296
+ | Claude Code | `plugins/bitbank-lab-mcp/.claude-plugin/plugin.json` | ✅ **GUI で入力**: `/plugin install` 直後に `userConfig` UI が表示され、OS キーチェーンに保管 |
294
297
  | Antigravity CLI(旧 Gemini CLI) | `gemini-extension.json` | ✅ **対話 prompt**: `settings` 配列で対話的に入力、`.env` に保管 |
295
298
  | Cursor | `.cursor-plugin/plugin.json` | ⚙️ **シェル環境変数のみ**: `BITBANK_API_KEY` / `BITBANK_API_SECRET` を環境変数に設定(Cursor は plugin 経由の prompt 未対応) |
296
299
  | Codex | `.codex-plugin/plugin.json` | ⚙️ **シェル環境変数のみ**: `BITBANK_API_KEY` / `BITBANK_API_SECRET` を環境変数に設定 |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bitbank-lab-mcp",
3
- "version": "0.5.0",
3
+ "version": "0.5.2",
4
4
  "description": "Experimental MCP server for bitbank — botters lab community edition. Market data, technical analysis, charting, and Private API trading tools.",
5
5
  "type": "module",
6
6
  "bin": {