xserver-files-setup

XServer Files セットアップスキル

いつ使うか

• このリポジトリをクローンした直後
• 新しい XServer サーバーを追加するとき
• セットアップが壊れて最初からやり直すとき
• ユーザーが「セットアップして」「設定して」「使えるようにして」と言ったとき

前提確認

セットアップを始める前に以下を確認する。満たさない場合はユーザーに伝えて中断する。

node --version   # v20 以上が必要

手順

以下の Phase を上から順に実行する。各 Phase の冒頭にエージェントの行動指示がある。

---

Phase 1: インストール

行動: 自動実行。ユーザーへの質問なし。

npm install

成功したら動作確認を実行:

XSERVER_FILES_CONFIG=config/example.config.json node src/cli.js servers

JSON が出力されれば Phase 2 へ進む。

---

Phase 2: ユーザー情報の収集

行動: ユーザーに以下の情報を質問する。一度にまとめて聞くこと。

設定ファイルを作成するために、XServer の情報を教えてください。XServer サーバーパネル（https://secure.xserver.ne.jp/xapanel/login/xserver/server/ ）で確認できます。

1. サーバー ID — サーバーパネル上部に表示されています（例: sv12345）
2. 操作対象のドメイン — ドメイン設定のドメイン一覧に表示されています（例: example.com）
3. ドキュメントルート — ドメイン一覧の「ドキュメントルート」列（例: /home/sv12345/example.com/public_html）。不明な場合は省略可（/home/<サーバーID>/<ドメイン>/public_html をデフォルトとして使用します）
4. ローカルワークスペースのパス — サイトファイルの pull 先ディレクトリ（例: ~/Dev/xserver-sites）。特に希望がなければデフォルトのままにします

複数ドメインがある場合はすべて聞く。複数サーバーがある場合はサーバーごとに聞く。

---

Phase 3: 設定ファイルの作成

行動: Phase 2 の回答をもとに自動生成する。ユーザーへの質問なし。

mkdir -p ~/.config/xserver-files-mcp

~/.config/xserver-files-mcp/config.json を以下の形式で作成:

{
  "defaultServer": "<サーバーID>",
  "localWorkspaceRoot": "<ワークスペースパス or ~/Dev/xserver-sites>",
  "servers": {
    "<サーバーID>": {
      "host": "<サーバーID>.xsrv.jp",
      "port": 10022,
      "username": "<サーバーID>",
      "privateKeyPath": "~/.ssh/xserver_<サーバーID>",
      "roots": {
        "<ドメイン1>": "<ドキュメントルート or /home/<サーバーID>/<ドメイン1>/public_html>",
        "<ドメイン2>": "/home/<サーバーID>/<ドメイン2>/public_html"
      }
    }
  }
}

作成後、設定が正しく読めるか確認:

node src/cli.js servers

エラーが出た場合は設定ファイルの JSON 構文を見直して修正する。

---

Phase 4: SSH 鍵の生成

行動: 既存の鍵があるか確認してから実行する。

ls ~/.ssh/xserver_<サーバーID> 2>/dev/null

鍵が既に存在する場合はユーザーに確認してから次のステップに進む:

~/.ssh/xserver_<サーバーID> に SSH 鍵が既にあります。この鍵を使いますか？新しく作り直しますか？