conoha-vps-mcp

name	conoha-vps-mcp
description	ConoHa VPS MCPサーバーの操作ガイド。サーバー作成・削除・起動・停止・リサイズ、ボリューム管理、セキュリティグループ設定など、ConoHa VPS APIをMCPツールで操作する際に参照する。「ConoHa」「VPS」「サーバー作成」「サーバー削除」「ボリューム」「セキュリティグループ」「conoha_get」「conoha_post」「conoha_delete_by_param」「フレーバー」「イメージ」「SSHキーペア」「スタートアップスクリプト」などのキーワードで発動する。

ConoHa VPS MCP 操作ガイド

前提条件

• MCP クライアントが ConoHa VPS MCP に接続済みで、OAuth 認可が完了していること
• Keystone token / tenant ID は MCP サーバーが OAuth アクセストークンのイントロスペクション結果から自動取得する。ツール利用者が OpenStack の認証情報（ユーザーID・パスワード）や tenant ID を直接指定する必要はない
• API リージョン・接続先はサーバー側の OpenStack base URL 設定で決まる

ツール概要

ツール名	HTTPメソッド	概要
fetch_url	—	指定URLからコンテンツを取得
encode_base64	—	文字列をBase64エンコード（1-10000文字）
conoha_get	GET	リソース一覧取得（10パス）
conoha_get_by_param	GET	パラメータ指定で個別リソース取得（6パス）
conoha_post	POST	リソース作成（5パス）
conoha_post_put_by_param	POST/PUT	リソース更新・操作（6パス）
conoha_delete_by_param	DELETE	リソース削除（5パス、confirm: true 必須）
create_server（プロンプト）	—	サーバー作成ウィザード

パス・パラメータの詳細は tool-path-reference.md を参照。

絶対遵守制約

1. パスワード自動生成禁止 — adminPass は必ずユーザーが指定した値のみを使用する。条件不適合でも再入力を依頼する。自動生成・提案をしない
2. ポート範囲自動設定禁止 — port_range_min / port_range_max は必ずユーザーに確認して指定する
3. user_data は encode_base64 必須 — スタートアップスクリプトを user_data に設定する場合、必ず encode_base64 ツールでエンコードした結果を使用する。自前でのBase64エンコードをしない
4. 削除は明示確認必須 — conoha_delete_by_param は必ず confirm: true を指定する
5. 名前タグ制約 — instance_name_tag とボリューム名は英数字・アンダースコア・ハイフンのみ（1-255文字）。SSHキーペア名は英数字・アンダースコア・ハイフンのみ（1文字以上、上限なし）

ワークフロー判定ツリー

サーバー作成フロー

1. conoha_get path="/flavors/detail" → フレーバー一覧取得、ユーザー要件に合うフレーバーを選択
2. conoha_get path="/v2/images?limit=200" → イメージ一覧取得、OS/バージョンを選択
3. conoha_get path="/types" → ボリュームタイプ一覧取得
4. conoha_post path="/volumes" → ブートボリューム作成（imageRef 必須）
5. （任意）セキュリティグループ・SSHキーペアの準備
6. ユーザーに adminPass を確認
7. conoha_post path="/servers" → サーバー作成

スタートアップスクリプト準備フロー

1. conoha_get path="/startup-scripts" → スタートアップスクリプト一覧取得
2. 一覧に該当スクリプトがある場合:
   a. fetch_url → スクリプト内容を取得
   b. encode_base64 → Base64エンコード
3. 一覧にない場合:
   a. 既存スクリプトを参考に新規スクリプトを作成
   b. encode_base64 → Base64エンコード
4. エンコード結果を user_data に設定してサーバー作成

サイズ制約: encode_base64 は入力最大10000文字。user_data はエンコード後 ≤65535バイト・デコード後 ≤49149バイトの padded Base64 である必要がある。長大なスクリプトはこの上限に収める。

サーバー操作フロー

操作	ツール	path	requestBody
起動	conoha_post_put_by_param	/action	{"os-start": null}
停止	conoha_post_put_by_param	/action	{"os-stop": null}
強制停止	conoha_post_put_by_param	/action	{"os-stop": {"force_shutdown": true}}
再起動	conoha_post_put_by_param	/action	{"reboot": {"type": "SOFT"}} or "HARD"
リサイズ	conoha_post_put_by_param	/action	{"resize": {"flavorRef": "<ID>"}}
リサイズ確定	conoha_post_put_by_param	/action	{"confirmResize": null}
リサイズ取消	conoha_post_put_by_param	/action	{"revertResize": null}
コンソール	conoha_post_put_by_param	/remote-consoles	{"remote_console": {"protocol": "vnc", "type": "novnc"}}
削除	conoha_delete_by_param	/servers	requestBody なし（flat 入力: param=サーバーID, confirm: true）

リサイズ手順: resize → サーバーが VERIFY_RESIZE 状態になるまで待機 → confirmResize で確定（または revertResize で取消）

セキュリティグループフロー

1. conoha_post path="/v2.0/security-groups" → セキュリティグループ作成
2. conoha_post path="/v2.0/security-group-rules" → ルール追加（ポート範囲はユーザーに確認）
3. conoha_get path="/v2.0/ports" → ポート一覧取得、対象サーバーのポートIDを特定
4. conoha_post_put_by_param path="/v2.0/ports" → ポートにセキュリティグループを適用

ボリューム管理フロー

■ ボリューム作成
  1. conoha_get path="/types" → ボリュームタイプ確認
  2. conoha_post path="/volumes" → ボリューム作成（size は正の整数 GB。利用可能サイズは /types と ConoHa プラン制約に従う。例: 30, 100, 200, 500, 1000, 5000, 10000 GB）

■ ボリュームアタッチ
  conoha_post_put_by_param path="/os-volume_attachments" param=サーバーID requestBody={"volumeAttachment": {"volumeId": "<ID>"}}

■ ボリューム更新
  conoha_post_put_by_param path="/volumes" param=ボリュームID requestBody={"volume": {"name": "...", "description": "..."}}

■ ボリューム削除
  conoha_delete_by_param path="/volumes" param=ボリュームID confirm=true

情報取得フロー

取得対象	ツール	path	param
サーバー一覧	conoha_get	/servers/detail	—
フレーバー一覧	conoha_get	/flavors/detail	—
イメージ一覧	conoha_get	/v2/images?limit=200	—
ボリューム一覧	conoha_get	/volumes/detail	—
SSHキーペア一覧	conoha_get	/os-keypairs	—
セキュリティグループ一覧	conoha_get	/v2.0/security-groups	—
ポート一覧	conoha_get	/v2.0/ports	—
サーバーのIP	conoha_get_by_param	/ips	サーバーID
CPU使用率	conoha_get_by_param	/rrd/cpu	サーバーID
ディスク使用率	conoha_get_by_param	/rrd/disk	サーバーID

ユーザー発話パターンとツール対応

発話パターン	使用ツール	パス
「サーバーを作成して」	conoha_post	/servers（事前に flavors, images, volumes, types を取得）
「サーバーを停止/起動/再起動して」	conoha_post_put_by_param	/action
「サーバーをリサイズして」	conoha_post_put_by_param	/action（resize → confirmResize）
「サーバーを削除して」	conoha_delete_by_param	/servers（confirm: true 必須）
「セキュリティグループを作成して」	conoha_post	/v2.0/security-groups + /v2.0/security-group-rules
「サーバーの状態を確認して」	conoha_get	/servers/detail
「コンソールに接続して」	conoha_post_put_by_param	/remote-consoles

エラー対応ガイド

エラー	原因	対処
401 Unauthorized	OAuth 認可切れ、scope 不足、Bearer token 不正	MCP クライアント側で再認可し、vps:read / vps:write scope を確認
409 Conflict	リソース競合（削除中のボリューム等）	状態を確認して再試行
400 Bad Request (adminPass)	パスワード要件不足	9-70文字、大小英字+数字+記号を含むか確認
400 Bad Request (port_range)	ポート範囲不正	0-65535の整数か確認
404 Not Found	リソースが存在しない	ID/名前を再確認

リファレンス

• ツール別パス・パラメータ一覧
• リクエストボディスキーマ全集
• 主要操作のワークフローレシピ