@autodevjapan/godd-mcp-alpha 0.20.0 → 0.22.0

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 (3) hide show
  1. package/README.md +67 -5
  2. package/dist/godd.cjs +86 -30862
  3. package/package.json +4 -4
package/README.md CHANGED
@@ -8,16 +8,38 @@ Cursor IDE 向けの AI プロンプト配信システム。MCP (Model Context P
8
8
  npm install -g @autodevjapan/godd-mcp-alpha
9
9
  ```
10
10
 
11
- ## セットアップ
11
+ ## セットアップ(推奨)
12
12
 
13
13
  ```bash
14
- # Cursor IDE に MCP サーバーを登録
14
+ # Cursor IDE に MCP サーバーを登録(mcp.json を自動生成)
15
15
  godd install --license-key=YOUR_LICENSE_KEY
16
16
 
17
17
  # プロジェクトの config.godd を自動生成
18
18
  godd init
19
19
  ```
20
20
 
21
+ > **`godd install` を使ってください。** mcp.json の手動編集は非推奨です。
22
+ > `godd install` は起動コマンド・PATH・ライセンスキーを正しく設定します。
23
+
24
+ ## mcp.json を手動で設定する場合
25
+
26
+ `godd install` が使えない環境では、`~/.cursor/mcp.json` を直接編集できます。
27
+ **`serve` 引数は必須です。** 省略するとインストーラーモードで起動し、MCP 通信が破綻します。
28
+
29
+ ```json
30
+ {
31
+ "mcpServers": {
32
+ "godd-mcp-alpha": {
33
+ "command": "npx",
34
+ "args": ["-y", "@autodevjapan/godd-mcp-alpha@latest", "serve"],
35
+ "env": {
36
+ "GODD_LICENSE_KEY": "GODD-XXXX-XXXX"
37
+ }
38
+ }
39
+ }
40
+ }
41
+ ```
42
+
21
43
  ## 使い方
22
44
 
23
45
  インストール後、Cursor IDE を再起動すると GoDD MCP α サーバーが自動で起動します。
@@ -54,12 +76,52 @@ Cursor IDE 上で利用できる GoDD プロンプト(MCP ツール)の一
54
76
  | `godd uninstall` | Cursor から MCP サーバーを削除 |
55
77
  | `godd serve` | MCP stdio サーバーを起動(Cursor が自動呼び出し) |
56
78
 
79
+ ## ライセンスキーの取得
80
+
81
+ GoDD MCP を利用するにはライセンスキーが必要です。以下の手順で取得できます。
82
+
83
+ 1. [GoDD 公式サイト](https://www.getgodd.dev/pricing) でプランを確認
84
+ 2. [アカウント登録](https://www.getgodd.dev/godd-admin/register) してサブスクリプションを購入
85
+ 3. [ダッシュボード](https://www.getgodd.dev/godd-admin/dashboard) からライセンスキーを発行
86
+
87
+ 発行されたライセンスキーを `godd install --license-key=YOUR_KEY` で設定してください。
88
+
57
89
  ## 動作要件
58
90
 
59
- - Node.js 20 以上
91
+ - Node.js 22 以上
60
92
  - Cursor IDE
61
- - GoDD ライセンスキー
93
+ - GoDD ライセンスキー([公式サイト](https://www.getgodd.dev/pricing)で取得)
94
+
95
+ ## トラブルシューティング
96
+
97
+ ### 「利用可能なツールが 0 個」と表示される
98
+
99
+ Cursor の MCP ログに以下のようなエラーが出ている場合:
100
+
101
+ ```
102
+ Unexpected end of JSON input
103
+ Unexpected token 'G', "GoDD MCP α"... is not valid JSON
104
+ ```
105
+
106
+ **原因**: `mcp.json` の `args` に `"serve"` が含まれていません。`serve` なしで起動するとインストーラーモード(人間向けテキスト出力)になり、Cursor が期待する JSON-RPC 通信に失敗します。
107
+
108
+ **対処法**:
109
+
110
+ ```bash
111
+ # 再インストールで mcp.json を正しく再生成
112
+ npx -y @autodevjapan/godd-mcp-alpha install --license-key=YOUR_KEY
113
+ ```
114
+
115
+ その後 Cursor を再起動してください。
116
+
117
+ ### ライセンスキーが別の端末に紐づいていると表示される
118
+
119
+ GoDD のライセンスキーは端末(デバイス)に紐づきます。別端末で使用する場合は新しいライセンスキーを発行してください。
120
+
121
+ ```bash
122
+ godd install --license-key=NEW_LICENSE_KEY
123
+ ```
62
124
 
63
125
  ## ライセンス
64
126
 
65
- Proprietary — GoDD ライセンスキーが必要です。
127
+ Proprietary — GoDD ライセンスキーが必要です。[公式サイト](https://www.getgodd.dev/pricing)からご購入いただけます。