xserver-mcp 1.1.0 → 1.3.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 +100 -33
- package/dist/index.js +1992 -276
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,33 +1,100 @@
|
|
|
1
|
-
# xserver-mcp
|
|
2
|
-
|
|
3
|
-
XServer
|
|
4
|
-
|
|
5
|
-
## 設定
|
|
6
|
-
|
|
7
|
-
Cursor の場合、`.cursor/mcp.json`（プロジェクトごと）または `~/.cursor/mcp.json
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
1
|
+
# xserver-mcp
|
|
2
|
+
|
|
3
|
+
XServer のレンタルサーバー / ドメイン / XServer for WordPress を AI コーディング環境（Cursor / Claude Code 等）から操作するための公式 MCP サーバー。
|
|
4
|
+
|
|
5
|
+
## 設定
|
|
6
|
+
|
|
7
|
+
Cursor の場合、`.cursor/mcp.json`（プロジェクトごと）または `~/.cursor/mcp.json`（ユーザー全体）に追加します。
|
|
8
|
+
`--services` は `server` / `domain` / `wphosting` をカンマ区切りで明示します。省略時は `server` です。`all` は指定できません。利用するサービスを明示してください。
|
|
9
|
+
|
|
10
|
+
複数サービスを横断して利用する場合:
|
|
11
|
+
|
|
12
|
+
```json
|
|
13
|
+
{
|
|
14
|
+
"mcpServers": {
|
|
15
|
+
"xserver": {
|
|
16
|
+
"command": "npx",
|
|
17
|
+
"args": ["-y", "xserver-mcp", "--services=server,domain,wphosting"],
|
|
18
|
+
"env": {
|
|
19
|
+
"XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
サービス間の権限や操作対象を強く分離したい場合は、以下のようにサービスごとのMCP設定を使用できます。
|
|
27
|
+
|
|
28
|
+
### サーバーAPI（`--services`省略時）
|
|
29
|
+
|
|
30
|
+
`XSERVER_SERVERNAME` は任意です。指定すると、すべてのServerツールの操作対象をそのサーバーに固定します。未指定の場合は各ツールの `servername` を使用し、APIキーの対象サーバーが1台だけなら省略時に自動選択します。対象が複数または「すべて」の場合は、各ツールで `servername` を指定してください。
|
|
31
|
+
|
|
32
|
+
```json
|
|
33
|
+
{
|
|
34
|
+
"mcpServers": {
|
|
35
|
+
"xserver": {
|
|
36
|
+
"command": "npx",
|
|
37
|
+
"args": ["-y", "xserver-mcp"],
|
|
38
|
+
"env": {
|
|
39
|
+
"XSERVER_API_KEY": "xs_xxxxxxxxxxxx",
|
|
40
|
+
"XSERVER_SERVERNAME": "xs123456.xsrv.jp"
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### ドメインサービスAPI
|
|
48
|
+
|
|
49
|
+
`SERVERNAME` は不要です。
|
|
50
|
+
|
|
51
|
+
```json
|
|
52
|
+
{
|
|
53
|
+
"mcpServers": {
|
|
54
|
+
"xserver-domain": {
|
|
55
|
+
"command": "npx",
|
|
56
|
+
"args": ["-y", "xserver-mcp", "--services=domain"],
|
|
57
|
+
"env": {
|
|
58
|
+
"XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
ドメインの取得・移管・更新の `execute` ツールは既定で無効です。検証時のみ `XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE=1` を設定してください。
|
|
66
|
+
|
|
67
|
+
### 課金操作の確認（Domain register / transfer / renew）
|
|
68
|
+
|
|
69
|
+
- 課金 `execute` ツールは環境変数ゲート（`XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE=1`）が必要です。
|
|
70
|
+
- 実申請時は MCP form elicitation によるネイティブ確認が必須です（Codex / Claude Code / Cursor の対話モード）。
|
|
71
|
+
- elicitation 非対応・headless・キャンセル時は fail-closed で実申請しません。
|
|
72
|
+
- Codex では MCP elicitation を許可し、課金 execute を自動承認対象に入れないでください。
|
|
73
|
+
- モデルが渡す `confirmed` だけでは実行できません。
|
|
74
|
+
|
|
75
|
+
### XServer for WordPress API
|
|
76
|
+
|
|
77
|
+
```json
|
|
78
|
+
{
|
|
79
|
+
"mcpServers": {
|
|
80
|
+
"xserver-wphosting": {
|
|
81
|
+
"command": "npx",
|
|
82
|
+
"args": ["-y", "xserver-mcp", "--services=wphosting"],
|
|
83
|
+
"env": {
|
|
84
|
+
"XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
他の AI ツールでも、同様の MCP 設定方式で利用できます。
|
|
92
|
+
|
|
93
|
+
## ドキュメント
|
|
94
|
+
|
|
95
|
+
- [XServer MCP マニュアル](https://www.xserver.ne.jp/manual/man_tool_mcp.php)
|
|
96
|
+
- [更新履歴](https://developer.xserver.ne.jp/changelog/)
|
|
97
|
+
|
|
98
|
+
## ライセンス
|
|
99
|
+
|
|
100
|
+
MIT
|