sacloud-mcp
Official本プロジェクトは提供を終了しました
2026年4月13日をもって、本リポジトリはアーカイブされました。
本プロジェクトはすでにメンテナンスを終了しており、
今後、機能追加、バグ修正、ならびにセキュリティアップデートは一切提供されません。
本プロジェクトの新規利用および継続利用は推奨されません。
sacloud/sacloud-mcp
概要
sacloud/sacloud-mcpはさくらのクラウド向けMCPサーバです。
Related MCP server: Sakura Cloud MCP Server
開発環境の構築
必要ツール
プロジェクトのクローン
git clone https://github.com/sacloud/sacloud-mcp.gituvのインストール
より詳細なインストール方法・使用方法については、uvのドキュメントを参照してください。
curl -LsSf https://astral.sh/uv/install.sh | sh環境構築同期
uv syncLLMへMCPをインストール
任意のLLMへMCPをインストールする。 一例としてclaude desktopでの設定を示す。
claude desktopの設定ファイルに以下を追記する。 なお、設定ファイルの位置はOS毎に以下の通りである。
macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sacloud": {
"command": "${HOME}/.local/bin/uv",
"args": [
"--directory",
"<<MCPサーバーのルートディレクトリ>>/src",
"run",
"main.py"
],
"env": {
"<<環境変数1>>": "<<値をコピーしてここへ貼り付ける>>",
"<<環境変数2>>": "<<値をコピーしてここへ貼り付ける>>"
}
}
}
}<<>>で示された要素について、以下を参考に適宜置き換える。
MCPサーバーのルートディレクトリ
例:
/Users/user/Source/sacloud-mcp
環境変数
使用する機能に応じて環境変数を設定。
さくらのクラウドのリソースにアクセスする場合、さくらのクラウドのAPIキーを参照して置き換える。
"ACCESS_TOKEN": "<<値をコピーしてここへ貼り付ける>>""ACCESS_TOKEN_SECRET": "<<値をコピーしてここへ貼り付ける>>"
さくらのオブジェクトストレージにアクセスする場合、さくらのオブジェクトストレージのAPIキーを参照して置き換える。
"OBJECTSTORAGE_ACCESS_KEY_ID": "<<値をコピーしてここへ貼り付ける>>""OBJECTSTORAGE_SECRET_ACCESS_KEY": "<<値をコピーしてここへ貼り付ける>>"
テスト
構成について
tests/conftest.pyには、全テストファイルで利用可能なfixtureが定義されており、
すべてのテストファイルから明示的なimport不要で利用できる。
準備
環境変数から認証情報を取得するため、テスト実行前にACCESS_TOKENとACCESS_TOKEN_SECRET設定する
export ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxx
export ACCESS_TOKEN_SECRET=xxxxxxxxxxxxxxxxxxxx
export OBJECTSTORAGE_ACCESS_KEY_ID=xxxxxxxxxxxxxxxxxxxx
export OBJECTSTORAGE_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxテスト実行
uv run pytestLicense
sacloud-mcp Copyright (C) 2025- The sacloud/sacloud-mcp authors.
This project is published under Apache 2.0 License.
Available Tools
41 toolsattach_serversC
さくらのクラウドAPIでロードバランサを作成します Args: zone (str): 作成対象のゾーン lb_id (str): LBのID vip (str): 仮想ipアドレス server_ips (list[str]): 関連づけるサーバのIP
Returns: dict: 作成されたロードバランサのJSONレスポンス
Inputs: zone (required), lb_id (required), vip (required), server_ips (required).
create_bridgeB
さくらのクラウドAPIでブリッジを作成します
Args: zone (str): 作成対象のゾーン name (str): ブリッジ名 description (str, optional): ブリッジの説明
Returns: dict: 作成されたブリッジのJSONレスポンス - Bridge: 作成されたブリッジ情報 - ID: ブリッジID - Name: ブリッジ名 - Description: 説明 - CreatedAt: 作成日時 - Region: リージョン情報
Inputs: zone (required), name (required), description.
create_diskA
さくらのクラウド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レスポンス
Inputs: zone (required), name (required), description (required), plan (required), +3 more.
create_loadbalancerB
さくらのクラウド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レスポンス
Inputs: zone (required), name (required), description (required), lb_ip (required), +4 more.
create_routerB
さくらのクラウド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: サブネット情報
Inputs: zone (required), name (required), network_mask_len (required), bandwidth_mbps (required), +1 more.
create_serverC
さくらのクラウドAPIからサーバを作成します 作成時は、サーバープラン一覧を取得し、CPU,メモリ数を参照しユーザに使用プランを選択させてください サーバ作成後、ディスクも作成してください
Args: zone (str): 作成対象ゾーン name (str): VM名(1-61文字) description (str): VMの説明(最大512文字) cpu (int): CPU数 mem (int): メモリ容量 gen (int): サーバの世代
Returns: dict: サーバ一覧のJSONレスポンス
Inputs: zone (required), name (required), description (required), cpu (required), +2 more.
create_switchB
さくらのクラウド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: ゾーン情報
Inputs: zone (required), name (required), description.
delete_bridgeC
さくらのクラウドAPIでブリッジを削除します
Args: zone (str): 削除対象のゾーン bridge_id (str): ブリッジID
Returns: dict: 削除結果のJSONレスポンス
Inputs: zone (required), bridge_id (required).
delete_routerC
さくらのクラウドAPIでルータを削除します
Args: zone (str): 削除対象のゾーン internet_id (str): ルータID
Returns: Union[Dict[str, Any], str]: 削除結果のJSONレスポンスまたはエラーメッセージ
Inputs: zone (required), internet_id (required).
get_api_manual_outlineB
さくらのクラウドのAPIマニュアルの目次を項目名と対応するurlを辞書型で返します。 Returns: dict: さくらのクラウドのマニュアルの目次 - 目次名(str): url(str)
Inputs: no named parameters.
get_archive_listC
さくらのクラウドAPIからアーカイブ一覧を取得します
Args: zone (str): 取得対象のゾーン
Returns: dict: アーカイブ一覧のJSONレスポンス
Inputs: zone (required).
get_bill_listC
さくらのクラウドAPIから指定プロジェクトIDの請求一覧を取得します
Args: account_id (str): プロジェクトID(アカウントID)
Returns: dict: 請求一覧のJSONレスポンス - is_ok: 処理結果 - Count: 件数 - ResponsedAt: レスポンス時刻 - Bills: 請求書情報のリスト
Inputs: account_id (required).
get_bill_list_by_monthB
さくらのクラウドAPIから指定プロジェクトIDの特定年月の請求一覧を取得します
Args: account_id (str): プロジェクトID(アカウントID) year (str): 年(YYYY形式) month (str): 月(MM形式)
Returns: dict: 特定年月の請求一覧のJSONレスポンス - is_ok: 処理結果 - Count: 件数 - ResponsedAt: レスポンス時刻 - Bills: 請求書情報のリスト
Inputs: account_id (required), year (required), month (required).
get_bridge_listB
さくらのクラウドAPIからブリッジ一覧を取得します
Args: zone (str): 取得対象のゾーン
Returns: dict: ブリッジ一覧のJSONレスポンス - Bridge: ブリッジのリスト - ID: ブリッジID - Name: ブリッジ名 - Description: 説明 - CreatedAt: 作成日時 - Region: リージョン情報
Inputs: zone (required).
get_coupon_listB
さくらのクラウドAPIから指定プロジェクトIDのクーポン一覧を取得します
Args: account_id (str): プロジェクトID(アカウントID)
Returns: dict: クーポン一覧のJSONレスポンス - is_ok: 処理結果 - Count: 件数 - ResponsedAt: レスポンス時刻 - Coupons: クーポン情報のリスト
Inputs: account_id (required).
get_detabasesC
さくらのクラウドAPIからデータベース一覧を取得します
Args: zone (str): 取得対象のゾーン。
Returns: dict: データベース一覧のJSONレスポンス
Inputs: zone (required).
get_diskC
さくらのクラウドAPIからディスク一覧を取得します。
Args: zone (str): 取得対象のゾーン。
Returns: dict: ディスク一覧のJSONレスポンス
Inputs: zone (required).
get_disk_planC
さくらのクラウドAPIからディスクプラン一覧を取得します
Inputs: zone (required).
get_icon_listB
さくらのクラウドAPIからアイコン一覧を取得します(全ゾーン共通)
Returns: dict: アイコン一覧のJSONレスポンス - Icons: アイコン情報のリスト - ID: アイコンID - Name: アイコン名 - Scope: スコープ - Image: 画像データ - CreatedAt: 作成日時 - ModifiedAt: 更新日時
Inputs: no named parameters.
get_icon_tag_listA
さくらのクラウドAPIからアイコンタグ一覧を取得します(全ゾーン共通)
Returns: dict: アイコンタグ一覧のJSONレスポンス - Tags: タグ情報のリスト - Name: タグ名 - Count: 該当するアイコン数
Inputs: no named parameters.
get_interface_listB
さくらのクラウド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: 更新日時
Inputs: zone (required).
get_loadbalancerC
さくらのクラウドAPIからロードバランサ一覧を取得します
Args: zone (str): 取得対象のゾーン。
Returns: dict: ロードバランサ一覧のJSONレスポンス
Inputs: zone (required).
get_manual_outlineB
さくらのクラウドの使い方のマニュアルの目次を項目名と対応するurlを辞書型で返します。 Returns: dict: さくらのクラウドのマニュアルの目次 - 目次名(dict): - url(str): - 目次名(dict): - url ....
Inputs: no named parameters.
get_objectstorage_accesskey_listC
さくらのクラウドAPIからオブジェクトストレージのアクセスキー一覧を取得します。
Returns: dict: アクセスキー一覧のJSONレスポンス - data: アクセスキーのリスト - id: アクセスキーID(文字列、例:"abcdefABCDEF0123456789") - secret: シークレットアクセスキー(文字列、作成時のみ返却される) - created_at: 作成日時(ISO8601形式、例:"2020-01-11T01:11:23.123456+09:00")
Inputs: site_id (required).
get_objectstorage_bucket_listB
さくらのクラウドAPIからオブジェクトストレージのバケット一覧を取得します。
Returns: - Name: バケット名 CreationDate: 作成日時
Inputs: no named parameters.
get_objectstorage_site_listB
さくらのクラウドAPIからオブジェクトストレージのサイト一覧を取得します。
Returns:
dict: サイト一覧のJSONレスポンス
- data: サイトのリスト
- api_zone: APIゾーンのリスト
- control_panel_url: コントロールパネルURL
- display_name_en_us: 英語表示名
- display_name_ja: 日本語表示名
- display_name: 表示名
- display_order: 表示順序
- endpoint_base: エンドポイントベース
- iam_endpoint: IAMエンドポイント
- iam_endpoint_for_control_panel: コントロールパネル用IAMエンドポイント
- id: サイトID
- region: リージョン
- s3_endpoint: S3エンドポイント
- s3_endpoint_for_control_panel: コントロールパネル用S3エンドポイント
- storage_zone: ストレージゾーンのリスト
Inputs: no named parameters.
get_packet_filter_listB
さくらのクラウドAPIからパケットフィルタ一覧を取得します
Args: zone (str): 取得対象のゾーン
Returns: dict: パケットフィルタ一覧のJSONレスポンス - PacketFilters: パケットフィルタ情報のリスト - ID: パケットフィルタID - Name: パケットフィルタ名 - Description: 説明 - RequiredHostVersion: 必要ホストバージョン - Expression: フィルタ式 - CreatedAt: 作成日時 - ModifiedAt: 更新日時
Inputs: zone (required).
get_priceB
さくらのクラウドの利用料金を取得します。 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): サービスクラスのパス
Inputs: no named parameters.
get_router_listB
さくらのクラウドAPIからルータ一覧を取得します
Args: zone (str): 取得対象のゾーン
Returns: dict: ルータ一覧のJSONレスポンス - Internet: ルータのリスト - ID: ルータID - Name: ルータ名 - Description: 説明 - BandWidthMbps: 帯域幅 - NetworkMaskLen: プレフィックス長 - Scope: スコープ - ServiceClass: サービスクラス - CreatedAt: 作成日時 - Zone: ゾーン情報 - Subnets: サブネット情報
Inputs: zone (required).
get_router_monitorB
さくらのクラウドAPIからルータのネットワーク流量のリソースモニタ情報を取得します
Args: zone (str): 取得対象のゾーン internet_id (str): ルータID start (str, optional): 開始時刻(ISO形式、デフォルトは終了時刻の24時間前) end (str, optional): 終了時刻(ISO形式、デフォルトは開始時刻の24時間後)
Returns: dict: ルータの監視データのJSONレスポンス - 監視データの詳細構造はAPIから返される形式に依存
Inputs: zone (required), internet_id (required), start, end.
get_server_listC
さくらのクラウドAPIからサーバ一覧を取得します
Args: zone (str): 取得対象のゾーン
Returns: dict: サーバ一覧のJSONレスポンス
Inputs: zone (required).
get_server_planC
さくらのクラウドAPIからサーバプラン一覧を取得します
Inputs: zone (required).
get_server_power_statusB
さくらのクラウドAPIからサーバーの電源状態を取得します
Args: zone (str): 対象ゾーン server_id (str): サーバーID
Returns: dict: 電源状態のJSONレスポンス - Instance: 電源状態情報 - Server: サーバー情報 - ID: サーバーID - Status: 現在の電源状態 ("up" または "down") - BeforeStatus: 以前の電源状態 - StatusChangedAt: 状態変更日時 - is_ok: 処理結果
Inputs: zone (required), server_id (required).
get_switch_listB
さくらのクラウドAPIからスイッチ一覧を取得します
Args: zone (str): 取得対象のゾーン。
Returns: dict: スイッチ一覧のJSONレスポンス - Switches: スイッチのリスト - ID: スイッチID - Name: スイッチ名 - Description: 説明 - Tags: タグのリスト - Icon: アイコン情報 - CreatedAt: 作成日時 - ModifiedAt: 更新日時 - Scope: スコープ - ServiceClass: サービスクラス - Zone: ゾーン情報 - ID: ゾーンID - Name: ゾーン名 - Description: ゾーンの説明 - Region: リージョン情報
Inputs: zone (required).
get_vpn_monitorB
さくらのクラウドAPIからVPNルータ一のネットワーク流量のリソースモニタ情報を取得します
Args: zone (str): 取得対象のゾーン。 vpn_id (str): vpnルータのリソースID start (str, optional): 開始時刻(ISO形式、デフォルトは終了時刻の24時間前) end (str, optional): 終了時刻(ISO形式、デフォルトは開始時刻の24時間後)
Returns: dict: VPNルータ一覧のJSONレスポンス
Inputs: zone (required), vpn_id (required), start, end.
get_vpn_router_listC
さくらのクラウドAPIからVPNルータ一覧を取得します
Args: zone (str): 取得対象のゾーン。
Returns: dict: VPNルータ一覧のJSONレスポンス
Inputs: zone (required).
read_api_manualC
指定したさくらのクラウドのAPIマニュアル(https://manual.sakura.ad.jp/cloud-api/~)のurlを受け取り、markdownに変換し、主要の内容を取得します。 Args: url (str): さくらのクラウドのAPIマニュアルのurl Returns: str: さくらのAPIクラウドのマニュアルの内容
Inputs: url (required).
read_manualC
指定したさくらのクラウドのマニュアル(https://manual.sakura.ad.jp/cloud/~)のurlを受け取り、markdownに変換し、主要の内容を取得します。 Args: url (str): さくらのクラウドのマニュアルのurl Returns: str: さくらのクラウドのマニュアルの内容
Inputs: url (required).
read_object_storage_api_manualB
指定したさくらのクラウドのオブジェクトストレージAPIマニュアル(https://manual.sakura.ad.jp/cloud-api/~)のurlを受け取り、markdownに変換し、主要の内容を取得します。 Returns: str: さくらのAPIクラウドのオブジェクトストレージのAPIマニュアルの内容
Inputs: no named parameters.
start_serverB
さくらのクラウドAPIでサーバーを起動します サーバの起動には時間がかかるため、リクエストがタイムアウトする場合があります
Args: zone (str): 対象ゾーン server_id (str): サーバーID
Returns: dict: 起動処理のJSONレスポンス - Instance: 電源状態情報 - Server: サーバー情報 - ID: サーバーID - Status: 処理後の電源状態 - BeforeStatus: 処理前の電源状態 - StatusChangedAt: 状態変更日時 - is_ok: 処理結果
Inputs: zone (required), server_id (required).
stop_serverB
さくらのクラウドAPIでサーバーを停止します
Args: zone (str): 対象ゾーン server_id (str): サーバーID force (bool, optional): 強制停止フラグ(デフォルト: False)
Returns: dict: 停止処理のJSONレスポンス - Instance: 電源状態情報 - Server: サーバー情報 - ID: サーバーID - Status: 処理後の電源状態 - BeforeStatus: 処理前の電源状態 - StatusChangedAt: 状態変更日時 - is_ok: 処理結果
Inputs: zone (required), server_id (required), force.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 41 tools
Most tools are clearly distinct by resource type and action, such as create_server vs. get_server_list. However, some potential confusion exists between get_manual_outline and get_api_manual_outline, which both fetch manual outlines but for different documentation sets, and between get_loadbalancer and attach_servers, which both involve load balancers but with overlapping purposes. Overall, the descriptions help clarify distinctions, but minor ambiguities remain.
The tool names follow a highly consistent verb_noun pattern throughout, such as create_server, get_server_list, delete_router, and start_server. All tools use snake_case uniformly, with verbs like create, get, delete, start, stop, and read applied predictably across resources. This consistency makes the tool set easy to navigate and understand.
With 41 tools, the count is excessive for a single server, making it overwhelming and difficult for agents to manage. While the domain (Sakura Cloud API) is broad, the tool set includes many specialized or redundant tools, such as multiple manual-reading tools and separate billing/coupon tools, which could be consolidated. This high number detracts from usability and coherence.
The tool set provides comprehensive coverage for core cloud infrastructure operations, including CRUD for servers, disks, routers, switches, and load balancers, along with monitoring, billing, and documentation tools. Minor gaps exist, such as missing update operations for some resources (e.g., update_server) and limited object storage management beyond listing, but agents can likely work around these with the available create/delete and read tools.
Related MCP Connectors
An MCP server for the STRG.com s3-compatible object storage network for all management operations. Full documentation access, ask questions, create buckets, configure scoped access keys, CORS rules, lifecycle policies and perform any S3 operation.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
MCP server for AI dialogue using various LLM models via AceDataCloud
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- FlicenseBqualityDmaintenanceAn MCP server that provides tools for interacting with AWS S3 buckets, enabling direct access to S3 operations through the Model Context Protocol.1-
- AlicenseBqualityFmaintenanceAn MCP server implementation that enables AI assistants to interact with and manage Sakura Cloud infrastructure, including servers, disks, networks, and containerized applications.4611ISC
- FlicenseNot gradedqualityDmaintenanceAn MCP Server that provides a natural language interface to Google Cloud Resource Settings API, enabling users to view and manage settings for Google Cloud resources through conversation.-
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with Google Cloud's Workload Manager API, allowing users to manage workloads through natural language commands.-