1. ホーム
  2. マニュアル
  3. 管理ツール
  4. XServer MCP Server

XServer MCP Server

XServer MCP Serverとは

Model Context Protocol（MCP）に対応した公式MCPサーバーです。「XServer API」の機能を、CursorやClaudeなどのMCPに対応したAIエージェントから直接実行できます。

対象プラン XServer VPS、ビジネスVPS、Windows Server、GPUサーバー

※無料プランおよびゲーム専用VPS（XServer GAMEs等）は対象外です。

ご利用方法

ご利用にはXServer APIキーが必要です。

1.APIキーの準備

XServerアカウントにログインし、「APIキー管理」からAPIキーを発行してください。
APIキーの発行方法は、マニュアル「XServer API」をご参照ください。

2.UUIDの確認

操作対象のUUIDをご確認ください。
UUIDは、ご契約時のメール、または「XServer VPS契約管理ページ」で確認できます。
（例: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）

3.MCPサーバーの設定

お使いのAIエージェントのMCP設定ファイルに、以下の内容を追加してください。
「XSERVER_API_KEY」はご自身の情報に置き換えてください。

Cursor の設定

プロジェクトの .cursor/mcp.json、またはグローバルの ~/.cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "xserver-vps": {
      "command": "npx",
      "args": ["-y", "xserver-mcp", "--services=vps"],
      "env": {
        "XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
      }
    }
  }
}
Claude Desktop の設定

Claude Desktopの設定ファイル（claude_desktop_config.json）に以下を追加します。

設定ファイルの場所
Windows %APPDATA%\Claude\claude_desktop_config.json
Mac ~/Library/Application Support/Claude/claude_desktop_config.json 
{
  "mcpServers": {
    "xserver-vps": {
      "command": "npx",
      "args": ["-y", "xserver-mcp", "--services=vps"],
      "env": {
        "XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
      }
    }
  }
}
VS Code（GitHub Copilot）の設定

プロジェクトの .vscode/mcp.json に以下を追加します。

{
  "servers": {
    "xserver-vps": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "xserver-mcp", "--services=vps"],
      "env": {
        "XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
      }
    }
  }
}
Claude Code の設定

ターミナルで以下のコマンドを実行します。

claude mcp add --transport stdio xserver-vps \
  --env XSERVER_API_KEY=xs_xxxxxxxxxxxx \
  -- npx -y xserver-mcp --services=vps
Codex の設定

ターミナルで以下のコマンドを実行します。

codex mcp add xserver-vps \
  --env XSERVER_API_KEY=xs_xxxxxxxxxxxx \
  -- npx -y xserver-mcp --services=vps
4.動作確認

設定完了後、AIエージェントに以下のように話しかけて動作を確認してください。
なお、対象VPSはUUID（例: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）で指定します。

  • 「VPSの一覧を見せて」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxの電源状態を見せて」

環境変数

XServer MCP Serverでは、以下の環境変数を使用します。

変数名 必須 説明
XSERVER_API_KEY ○ XServer APIキー（xs_ で始まる文字列）
XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE 任意 新規お申し込みやOS再インストールを行う場合に1を設定 
"XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE": "1"

利用可能な機能

XServer MCP Serverでは、XServer APIで提供されている機能をAIエージェントを通じてご利用いただけます。

カテゴリ 主な操作
VPS情報 一覧 / 詳細 / メモ変更 / サーバー名変更 / 逆引きホスト名変更
電源操作 電源状態の確認 / 起動 / 再起動 / 停止
パケットフィルター設定 取得 / ON・OFF / ルール追加・変更・削除
OS再インストール イメージ一覧 / 実行 / 進捗確認 / 操作保護の取得・変更
新規お申し込み プラン・料金の確認 / 申込 / 状況確認

各APIの詳細な仕様については、APIリファレンスをご参照ください。

使用例

AIエージェントへの指示例
  • 「VPSの一覧を見せて」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxを再起動して」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxのパケットフィルターの設定を見せて」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxのメモを変更して」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxの操作保護を確認して」

注意事項

マニュアル一覧へ戻る