Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ACCESS_TOKEN | No | Sakura Cloud API Access Token | |
| ACCESS_TOKEN_SECRET | No | Sakura Cloud API Access Token Secret | |
| OBJECTSTORAGE_ACCESS_KEY_ID | No | Sakura Object Storage Access Key ID | |
| OBJECTSTORAGE_SECRET_ACCESS_KEY | No | Sakura Object Storage Secret Access Key |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_manual_outline | さくらのクラウドの使い方のマニュアルの目次を項目名と対応するurlを辞書型で返します。 Returns: dict: さくらのクラウドのマニュアルの目次 - 目次名(dict): - url(str): - 目次名(dict): - url .... |
| read_manual | 指定したさくらのクラウドのマニュアル(https://manual.sakura.ad.jp/cloud/~)のurlを受け取り、markdownに変換し、主要の内容を取得します。 Args: url (str): さくらのクラウドのマニュアルのurl Returns: str: さくらのクラウドのマニュアルの内容 |
| get_price | さくらのクラウドの利用料金を取得します。 Returns: dict: さくらのクラウドの利用料金情報 - Count (int): 取得したサービスクラスの総数 - ResponsedAt (str): レスポンス生成日時(ISO 8601 形式) - ServiceClasses (dict): - <キー> (dict): 各サービスクラスの詳細情報 - DisplayName (str): プランの表示名 - IsPublic (bool): 公開フラグ - Price (dict): - Daily (int): 日額(円) - Hourly (int): 時額(円) - Monthly (int): 月額(円) - Zone (str): ゾーン名 - ServiceCharge (str): 課金種別 - ServiceClassID (int): サービスクラス ID - ServiceClassName (str): サービスクラス名(内部名称) - ServiceClassPath (str): サービスクラスのパス |
| get_api_manual_outline | さくらのクラウドのAPIマニュアルの目次を項目名と対応するurlを辞書型で返します。 Returns: dict: さくらのクラウドのマニュアルの目次 - 目次名(str): url(str) |
| read_api_manual | 指定したさくらのクラウドのAPIマニュアル(https://manual.sakura.ad.jp/cloud-api/~)のurlを受け取り、markdownに変換し、主要の内容を取得します。 Args: url (str): さくらのクラウドのAPIマニュアルのurl Returns: str: さくらのAPIクラウドのマニュアルの内容 |
| read_object_storage_api_manual | 指定したさくらのクラウドのオブジェクトストレージAPIマニュアル(https://manual.sakura.ad.jp/cloud-api/~)のurlを受け取り、markdownに変換し、主要の内容を取得します。 Returns: str: さくらのAPIクラウドのオブジェクトストレージのAPIマニュアルの内容 |
| get_server_list | さくらのクラウドAPIからサーバ一覧を取得します Args: zone (str): 取得対象のゾーン Returns: dict: サーバ一覧のJSONレスポンス |
| get_server_plan | さくらのクラウドAPIからサーバプラン一覧を取得します |
| create_server | さくらのクラウドAPIからサーバを作成します 作成時は、サーバープラン一覧を取得し、CPU,メモリ数を参照しユーザに使用プランを選択させてください サーバ作成後、ディスクも作成してください Args: zone (str): 作成対象ゾーン name (str): VM名(1-61文字) description (str): VMの説明(最大512文字) cpu (int): CPU数 mem (int): メモリ容量 gen (int): サーバの世代 Returns: dict: サーバ一覧のJSONレスポンス |
| get_server_power_status | さくらのクラウドAPIからサーバーの電源状態を取得します Args: zone (str): 対象ゾーン server_id (str): サーバーID Returns: dict: 電源状態のJSONレスポンス - Instance: 電源状態情報 - Server: サーバー情報 - ID: サーバーID - Status: 現在の電源状態 ("up" または "down") - BeforeStatus: 以前の電源状態 - StatusChangedAt: 状態変更日時 - is_ok: 処理結果 |
| stop_server | さくらのクラウドAPIでサーバーを停止します Args: zone (str): 対象ゾーン server_id (str): サーバーID force (bool, optional): 強制停止フラグ(デフォルト: False) Returns: dict: 停止処理のJSONレスポンス - Instance: 電源状態情報 - Server: サーバー情報 - ID: サーバーID - Status: 処理後の電源状態 - BeforeStatus: 処理前の電源状態 - StatusChangedAt: 状態変更日時 - is_ok: 処理結果 |
| start_server | さくらのクラウドAPIでサーバーを起動します サーバの起動には時間がかかるため、リクエストがタイムアウトする場合があります Args: zone (str): 対象ゾーン server_id (str): サーバーID Returns: dict: 起動処理のJSONレスポンス - Instance: 電源状態情報 - Server: サーバー情報 - ID: サーバーID - Status: 処理後の電源状態 - BeforeStatus: 処理前の電源状態 - StatusChangedAt: 状態変更日時 - is_ok: 処理結果 |
| get_interface_list | さくらのクラウドAPIからネットワークインターフェース一覧を取得します Args: zone (str): 取得対象のゾーン Returns: dict: インターフェース一覧のJSONレスポンス - Interfaces: インターフェース情報のリスト - ID: インターフェースID - MACAddress: MACアドレス - IPAddress: IPアドレス - UserIPAddress: ユーザーIPアドレス - HostName: ホスト名 - Switch: 接続されているスイッチ情報 - ID: スイッチID - Name: スイッチ名 - Scope: スコープ - Server: 所属サーバー情報 - ID: サーバーID - Name: サーバー名 - PacketFilter: パケットフィルタ情報 - ID: パケットフィルタID - Name: パケットフィルタ名 - CreatedAt: 作成日時 - ModifiedAt: 更新日時 |
| get_packet_filter_list | さくらのクラウドAPIからパケットフィルタ一覧を取得します Args: zone (str): 取得対象のゾーン Returns: dict: パケットフィルタ一覧のJSONレスポンス - PacketFilters: パケットフィルタ情報のリスト - ID: パケットフィルタID - Name: パケットフィルタ名 - Description: 説明 - RequiredHostVersion: 必要ホストバージョン - Expression: フィルタ式 - CreatedAt: 作成日時 - ModifiedAt: 更新日時 |
| get_disk | さくらのクラウドAPIからディスク一覧を取得します。 Args: zone (str): 取得対象のゾーン。 Returns: dict: ディスク一覧のJSONレスポンス |
| create_disk | さくらのクラウドAPIでディスクを作成して、サーバーに接続します。 作成時は、ディスクプラン一覧を取得し、使用可能なプランとディスク容量を参照しユーザに選択させてください アーカイブIDはアーカイブ一覧から取得してください Args: zone (str): 作成対象のゾーン name (str): ディスク名(1-64文字) description (str, optional): ルータの説明(最大512文字) plan (int): 標準プランは4、SSDプランは2 size_mb (int): ディスクに割り当てる容量(例:20480(20GB)) source_archive_id (str): アーカイブのID server_id (str): 紐付けるサーバ bandwidth_mbps (int): 帯域幅(100、500、または1000 Mbps) Returns: dict: 作成されたディスクのJSONレスポンス |
| get_disk_plan | さくらのクラウドAPIからディスクプラン一覧を取得します |
| get_archive_list | さくらのクラウドAPIからアーカイブ一覧を取得します Args: zone (str): 取得対象のゾーン Returns: dict: アーカイブ一覧のJSONレスポンス |
| get_bridge_list | さくらのクラウドAPIからブリッジ一覧を取得します Args: zone (str): 取得対象のゾーン Returns: dict: ブリッジ一覧のJSONレスポンス - Bridge: ブリッジのリスト - ID: ブリッジID - Name: ブリッジ名 - Description: 説明 - CreatedAt: 作成日時 - Region: リージョン情報 |
| create_bridge | さくらのクラウドAPIでブリッジを作成します Args: zone (str): 作成対象のゾーン name (str): ブリッジ名 description (str, optional): ブリッジの説明 Returns: dict: 作成されたブリッジのJSONレスポンス - Bridge: 作成されたブリッジ情報 - ID: ブリッジID - Name: ブリッジ名 - Description: 説明 - CreatedAt: 作成日時 - Region: リージョン情報 |
| delete_bridge | さくらのクラウドAPIでブリッジを削除します Args: zone (str): 削除対象のゾーン bridge_id (str): ブリッジID Returns: dict: 削除結果のJSONレスポンス |
| get_switch_list | さくらのクラウドAPIからスイッチ一覧を取得します Args: zone (str): 取得対象のゾーン。 Returns: dict: スイッチ一覧のJSONレスポンス - Switches: スイッチのリスト - ID: スイッチID - Name: スイッチ名 - Description: 説明 - Tags: タグのリスト - Icon: アイコン情報 - CreatedAt: 作成日時 - ModifiedAt: 更新日時 - Scope: スコープ - ServiceClass: サービスクラス - Zone: ゾーン情報 - ID: ゾーンID - Name: ゾーン名 - Description: ゾーンの説明 - Region: リージョン情報 |
| create_switch | さくらのクラウドAPIでスイッチを作成します Args: zone (str): 作成対象のゾーン name (str): スイッチ名(1-64文字) description (str, optional): スイッチの説明(最大512文字) Returns: dict: 作成されたスイッチのJSONレスポンス - Switch: 作成されたスイッチ情報 - ID: スイッチID - Name: スイッチ名 - Description: 説明 - Tags: タグのリスト - Icon: アイコン情報 - CreatedAt: 作成日時 - ModifiedAt: 更新日時 - Scope: スコープ - ServiceClass: サービスクラス - Zone: ゾーン情報 |
| get_router_list | さくらのクラウドAPIからルータ一覧を取得します Args: zone (str): 取得対象のゾーン Returns: dict: ルータ一覧のJSONレスポンス - Internet: ルータのリスト - ID: ルータID - Name: ルータ名 - Description: 説明 - BandWidthMbps: 帯域幅 - NetworkMaskLen: プレフィックス長 - Scope: スコープ - ServiceClass: サービスクラス - CreatedAt: 作成日時 - Zone: ゾーン情報 - Subnets: サブネット情報 |
| get_router_monitor | さくらのクラウドAPIからルータのネットワーク流量のリソースモニタ情報を取得します Args: zone (str): 取得対象のゾーン internet_id (str): ルータID start (str, optional): 開始時刻(ISO形式、デフォルトは終了時刻の24時間前) end (str, optional): 終了時刻(ISO形式、デフォルトは開始時刻の24時間後) Returns: dict: ルータの監視データのJSONレスポンス - 監視データの詳細構造はAPIから返される形式に依存 |
| create_router | さくらのクラウドAPIでルータを作成します Args: zone (str): 作成対象のゾーン name (str): ルータ名(1-64文字) network_mask_len (int): プレフィックス長(28または27) bandwidth_mbps (int): 帯域幅(100、500、または1000 Mbps) description (str, optional): ルータの説明(最大512文字) Returns: dict: 作成されたルータのJSONレスポンス - Internet: 作成されたルータ情報 - ID: ルータID - Name: ルータ名 - Description: 説明 - BandWidthMbps: 帯域幅 - NetworkMaskLen: プレフィックス長 - Scope: スコープ - ServiceClass: サービスクラス - CreatedAt: 作成日時 - Zone: ゾーン情報 - Subnets: サブネット情報 |
| delete_router | さくらのクラウドAPIでルータを削除します Args: zone (str): 削除対象のゾーン internet_id (str): ルータID Returns: Union[Dict[str, Any], str]: 削除結果のJSONレスポンスまたはエラーメッセージ |
| get_detabases | さくらのクラウドAPIからデータベース一覧を取得します Args: zone (str): 取得対象のゾーン。 Returns: dict: データベース一覧のJSONレスポンス |
| get_loadbalancer | さくらのクラウドAPIからロードバランサ一覧を取得します Args: zone (str): 取得対象のゾーン。 Returns: dict: ロードバランサ一覧のJSONレスポンス |
| create_loadbalancer | さくらのクラウドAPIでロードバランサを作成します Args: zone (str): 作成対象のゾーン name (str): ロードバランサ名(1-64文字) description (str, optional): ルータの説明(最大512文字) lb_ip (str) ロードバランサに付与されるip address switch_id (str): 紐付けるスイッチのID vrid (str): (1から255) network_mask (str): プレフィックス長(8~29) default_router(str, optional) ゲートウェイ Returns: dict: 作成されたロードバランサのJSONレスポンス |
| attach_servers | さくらのクラウドAPIでロードバランサを作成します Args: zone (str): 作成対象のゾーン lb_id (str): LBのID vip (str): 仮想ipアドレス server_ips (list[str]): 関連づけるサーバのIP Returns: dict: 作成されたロードバランサのJSONレスポンス |
| get_vpn_router_list | さくらのクラウドAPIからVPNルータ一覧を取得します Args: zone (str): 取得対象のゾーン。 Returns: dict: VPNルータ一覧のJSONレスポンス |
| get_vpn_monitor | さくらのクラウドAPIからVPNルータ一のネットワーク流量のリソースモニタ情報を取得します Args: zone (str): 取得対象のゾーン。 vpn_id (str): vpnルータのリソースID start (str, optional): 開始時刻(ISO形式、デフォルトは終了時刻の24時間前) end (str, optional): 終了時刻(ISO形式、デフォルトは開始時刻の24時間後) Returns: dict: VPNルータ一覧のJSONレスポンス |
| get_objectstorage_site_list | さくらのクラウドAPIからオブジェクトストレージのサイト一覧を取得します。 Returns:
dict: サイト一覧のJSONレスポンス
- data: サイトのリスト
- api_zone: APIゾーンのリスト
- control_panel_url: コントロールパネルURL
- display_name_en_us: 英語表示名
- display_name_ja: 日本語表示名 |
| get_objectstorage_accesskey_list | さくらのクラウドAPIからオブジェクトストレージのアクセスキー一覧を取得します。 Returns: dict: アクセスキー一覧のJSONレスポンス - data: アクセスキーのリスト - id: アクセスキーID(文字列、例:"abcdefABCDEF0123456789") - secret: シークレットアクセスキー(文字列、作成時のみ返却される) - created_at: 作成日時(ISO8601形式、例:"2020-01-11T01:11:23.123456+09:00") |
| get_objectstorage_bucket_list | さくらのクラウドAPIからオブジェクトストレージのバケット一覧を取得します。 Returns: - Name: バケット名 CreationDate: 作成日時 |
| get_bill_list | さくらのクラウドAPIから指定プロジェクトIDの請求一覧を取得します Args: account_id (str): プロジェクトID(アカウントID) Returns: dict: 請求一覧のJSONレスポンス - is_ok: 処理結果 - Count: 件数 - ResponsedAt: レスポンス時刻 - Bills: 請求書情報のリスト |
| get_bill_list_by_month | さくらのクラウドAPIから指定プロジェクトIDの特定年月の請求一覧を取得します Args: account_id (str): プロジェクトID(アカウントID) year (str): 年(YYYY形式) month (str): 月(MM形式) Returns: dict: 特定年月の請求一覧のJSONレスポンス - is_ok: 処理結果 - Count: 件数 - ResponsedAt: レスポンス時刻 - Bills: 請求書情報のリスト |
| get_coupon_list | さくらのクラウドAPIから指定プロジェクトIDのクーポン一覧を取得します Args: account_id (str): プロジェクトID(アカウントID) Returns: dict: クーポン一覧のJSONレスポンス - is_ok: 処理結果 - Count: 件数 - ResponsedAt: レスポンス時刻 - Coupons: クーポン情報のリスト |
| get_icon_list | さくらのクラウドAPIからアイコン一覧を取得します(全ゾーン共通) Returns: dict: アイコン一覧のJSONレスポンス - Icons: アイコン情報のリスト - ID: アイコンID - Name: アイコン名 - Scope: スコープ - Image: 画像データ - CreatedAt: 作成日時 - ModifiedAt: 更新日時 |
| get_icon_tag_list | さくらのクラウドAPIからアイコンタグ一覧を取得します(全ゾーン共通) Returns: dict: アイコンタグ一覧のJSONレスポンス - Tags: タグ情報のリスト - Name: タグ名 - Count: 該当するアイコン数 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |