xserver-mcp 1.3.0 → 1.5.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.
- package/README.md +34 -8
- package/dist/index.js +1422 -692
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# xserver-mcp
|
|
2
2
|
|
|
3
|
-
XServer のレンタルサーバー / ドメイン / XServer for WordPress を AI コーディング環境（Cursor / Claude Code 等）から操作するための公式 MCP サーバー。
|
|
3
|
+
XServer のレンタルサーバー / ドメイン / XServer for WordPress / XServer VPS を AI コーディング環境（Cursor / Claude Code 等）から操作するための公式 MCP サーバー。
|
|
4
4
|
|
|
5
5
|
## 設定
|
|
6
6
|
|
|
7
7
|
Cursor の場合、`.cursor/mcp.json`（プロジェクトごと）または `~/.cursor/mcp.json`（ユーザー全体）に追加します。
|
|
8
|
-
`--services` は `server` / `domain` / `wphosting` をカンマ区切りで明示します。省略時は `server` です。`all` は指定できません。利用するサービスを明示してください。
|
|
8
|
+
`--services` は `server` / `domain` / `wphosting` / `vps` をカンマ区切りで明示します。省略時は `server` です。`all` は指定できません。利用するサービスを明示してください。
|
|
9
9
|
|
|
10
10
|
複数サービスを横断して利用する場合:
|
|
11
11
|
|
|
@@ -14,7 +14,7 @@ Cursor の場合、`.cursor/mcp.json`（プロジェクトごと）または `~/
|
|
|
14
14
|
"mcpServers": {
|
|
15
15
|
"xserver": {
|
|
16
16
|
"command": "npx",
|
|
17
|
-
"args": ["-y", "xserver-mcp", "--services=server,domain,wphosting"],
|
|
17
|
+
"args": ["-y", "xserver-mcp", "--services=server,domain,wphosting,vps"],
|
|
18
18
|
"env": {
|
|
19
19
|
"XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
|
|
20
20
|
}
|
|
@@ -23,11 +23,11 @@ Cursor の場合、`.cursor/mcp.json`（プロジェクトごと）または `~/
|
|
|
23
23
|
}
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
サービス間の権限や操作対象を強く分離したい場合は、以下のようにサービスごとのMCP設定を使用できます。
|
|
26
|
+
サービス間の権限や操作対象を強く分離したい場合は、以下のようにサービスごとの MCP 設定を使用できます。
|
|
27
27
|
|
|
28
|
-
### サーバーAPI（`--services`省略時）
|
|
28
|
+
### サーバー API（`--services`省略時）
|
|
29
29
|
|
|
30
|
-
`XSERVER_SERVERNAME` は任意です。指定すると、すべてのServerツールの操作対象をそのサーバーに固定します。未指定の場合は各ツールの `servername` を使用し、APIキーの対象サーバーが1台だけなら省略時に自動選択します。対象が複数または「すべて」の場合は、各ツールで `servername` を指定してください。
|
|
30
|
+
`XSERVER_SERVERNAME` は任意です。指定すると、すべての Server ツールの操作対象をそのサーバーに固定します。未指定の場合は各ツールの `servername` を使用し、API キーの対象サーバーが 1 台だけなら省略時に自動選択します。対象が複数または「すべて」の場合は、各ツールで `servername` を指定してください。
|
|
31
31
|
|
|
32
32
|
```json
|
|
33
33
|
{
|
|
@@ -44,7 +44,9 @@ Cursor の場合、`.cursor/mcp.json`（プロジェクトごと）または `~/
|
|
|
44
44
|
}
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
-
|
|
47
|
+
Server ではプラン・契約一覧・メモ・申込状況に加え、新規契約の `preview` ツールを利用できます。申込時は、意図しない自動更新を防ぐため `auto_renew` に `enabled`（有効）または `disabled`（無効）の明示指定が必須です。課金される新規契約の `execute` ツールは既定で無効です。意図して実申請する場合は `XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE=1` で有効化したうえで、MCP form elicitation によるネイティブ確認が必要です。
|
|
48
|
+
|
|
49
|
+
### ドメインサービス API
|
|
48
50
|
|
|
49
51
|
`SERVERNAME` は不要です。
|
|
50
52
|
|
|
@@ -62,16 +64,37 @@ Cursor の場合、`.cursor/mcp.json`（プロジェクトごと）または `~/
|
|
|
62
64
|
}
|
|
63
65
|
```
|
|
64
66
|
|
|
65
|
-
ドメインの取得・移管・更新の `execute`
|
|
67
|
+
ドメインの取得・移管・更新の `execute` ツールは既定で無効です。課金操作を意図して実行する場合は `XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE=1` を設定してください。
|
|
66
68
|
|
|
67
69
|
### 課金操作の確認（Domain register / transfer / renew）
|
|
68
70
|
|
|
69
71
|
- 課金 `execute` ツールは環境変数ゲート（`XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE=1`）が必要です。
|
|
70
72
|
- 実申請時は MCP form elicitation によるネイティブ確認が必須です（Codex / Claude Code / Cursor の対話モード）。
|
|
73
|
+
- 確認フォームには、正式なサービス名・プラン名（カタカナと plan_id の併記）・契約期間・希望サーバーID・自動更新・お取次店コード（指定時）・お支払い金額（税込）・お支払い方法と利用規約・個人情報の取り扱いのリンクを表示します。
|
|
71
74
|
- elicitation 非対応・headless・キャンセル時は fail-closed で実申請しません。
|
|
72
75
|
- Codex では MCP elicitation を許可し、課金 execute を自動承認対象に入れないでください。
|
|
73
76
|
- モデルが渡す `confirmed` だけでは実行できません。
|
|
74
77
|
|
|
78
|
+
### XServer VPS API
|
|
79
|
+
|
|
80
|
+
```json
|
|
81
|
+
{
|
|
82
|
+
"mcpServers": {
|
|
83
|
+
"xserver-vps": {
|
|
84
|
+
"command": "npx",
|
|
85
|
+
"args": ["-y", "xserver-mcp", "--services=vps"],
|
|
86
|
+
"env": {
|
|
87
|
+
"XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
XServer VPS、ビジネスVPS、Windows Server、GPUサーバーの情報取得、電源操作、パケットフィルター、OS再インストール、操作保護を利用できます。新規お申し込みは XServer VPS・ビジネスVPSの Linux 標準 OS のみが対象です。
|
|
95
|
+
|
|
96
|
+
新規お申し込みとOS再インストールの `execute` ツールは既定で無効です。利用する場合は `XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE=1` を設定し、MCP form elicitation 対応クライアントの確認フォームで明示的に承認してください。非対応・キャンセル時は実行されません。
|
|
97
|
+
|
|
75
98
|
### XServer for WordPress API
|
|
76
99
|
|
|
77
100
|
```json
|
|
@@ -88,11 +111,14 @@ Cursor の場合、`.cursor/mcp.json`（プロジェクトごと）または `~/
|
|
|
88
111
|
}
|
|
89
112
|
```
|
|
90
113
|
|
|
114
|
+
WPhosting ではプラン・契約一覧・メモに加え、新規契約の `preview` ツールを利用できます。申込時は、意図しない自動更新を防ぐため `auto_renew` に `enabled`（有効）または `disabled`（無効）の明示指定が必須です。課金される新規契約の `execute` ツールは既定で無効です。意図して実申請する場合は `XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE=1` で有効化したうえで、MCP form elicitation によるネイティブ確認が必要です。
|
|
115
|
+
|
|
91
116
|
他の AI ツールでも、同様の MCP 設定方式で利用できます。
|
|
92
117
|
|
|
93
118
|
## ドキュメント
|
|
94
119
|
|
|
95
120
|
- [XServer MCP マニュアル](https://www.xserver.ne.jp/manual/man_tool_mcp.php)
|
|
121
|
+
- [XServer VPS MCP マニュアル](https://vps.xserver.ne.jp/support/manual/man_tool_mcp.php)
|
|
96
122
|
- [更新履歴](https://developer.xserver.ne.jp/changelog/)
|
|
97
123
|
|
|
98
124
|
## ライセンス
|