さくらクラウドMCPサーバー

Sakura Cloud の API と対話するためのモデルコンテキストプロトコル (MCP) サーバー実装。

MCPとは何ですか?

モデルコンテキストプロトコル（MCP）は、AIアプリケーションが外部システムやデータソースと安全にやり取りできるようにする標準化された通信プロトコルです。MCPはクライアントサーバーアーキテクチャを採用しており、LLMアプリケーションがリソースやツールを公開するサーバーへの接続を開始します。

概要

このプロジェクトは、AIアシスタントが標準化されたインターフェースを介してSakura Cloudインフラストラクチャと対話できるようにするMCPサーバーを実装します。これにより、AIアシスタントは以下のことが可能になります。

サーバー、ディスク、ネットワークなどのSakura Cloudリソースにアクセスします
ツールを使用してリソースを一覧表示し、特定のリソースに関する詳細情報を取得します
認証を必要とせずに公開価格情報を照会する
AppRunコンテナ化アプリケーションを管理する

前提条件

Node.js (v16 以上)
Sakura Cloud API 認証情報（トークンとシークレット）
Claude で使用するための Claude デスクトップアプリ (MCP は現在デスクトップアプリでのみサポートされています)

インストール

# Clone the repository
git clone https://github.com/hidenorigoto/sacloud-mcp.git
cd sacloud-mcp

# Install dependencies
npm install

# Build the project
npm run build

構成

次の環境変数を設定します。

SACLOUD_API_TOKEN : さくらクラウドAPIトークン
SACLOUD_API_SECRET : Sakura Cloud APIシークレット

使用法

利用可能なリソース

リソースURI	説明
`sakura:///servers`	Sakura Cloudアカウント内のすべてのサーバーを一覧表示します
`sakura:///switches`	Sakura Cloudアカウント内のすべてのスイッチを一覧表示します
`sakura:///appliances`	Sakura Cloudアカウント内のすべてのアプライアンスを一覧表示します
`sakura:///disks`	Sakura Cloud アカウント内のすべてのディスクを一覧表示します
`sakura:///archives`	Sakura Cloudアカウント内のすべてのアーカイブを一覧表示します
`sakura:///cdrom`	Sakura Cloud アカウント内のすべての ISO イメージ (CD-ROM) を一覧表示します
`sakura:///bridge`	Sakura Cloud アカウント内のすべてのブリッジを一覧表示します
`sakura:///internet`	Sakura Cloudアカウント内のすべてのルーターを一覧表示します
`sakura:///interface`	Sakura Cloud アカウント内のすべてのネットワークインターフェースを一覧表示します
`sakura:///icon`	Sakura Cloudアカウント内のすべてのアイコンを一覧表示します
`sakura:///note`	Sakura Cloud アカウント内のすべての起動スクリプトとメモを一覧表示します
`sakura:///sshkey`	Sakura Cloud アカウント内のすべての SSH キーを一覧表示します
`sakura:///region`	Sakura Cloud アカウントのすべてのリージョンを一覧表示します
`sakura:///zone`	Sakura Cloud アカウント内のすべてのゾーンを一覧表示します
`sakura:///product`	Sakura Cloud アカウントで利用可能なすべての製品を一覧表示します
`sakura:///commonserviceitem`	Sakura Cloud アカウントの一般的なサービス項目 (DNS、シンプルモニターなど) をすべて一覧表示します
`sakura:///license`	Sakura Cloud アカウントのすべてのライセンスを一覧表示します
`sakura:///auth-status`	現在の認証ステータスと権限を表示します
`sakura:///bill`	毎月の請求情報を表示します
`sakura:///bill-detail`	請求情報の詳細な内訳を表示します
`sakura:///coupon`	利用可能なクーポンをすべて一覧表示します
`sakura:///privatehost`	Sakura Cloud アカウント内のすべてのプライベートホストを一覧表示します
`sakura:///public-price`	Sakura Cloud サービスの公開価格情報を表示します (認証は不要)
`sakura:///apprun`	Sakura Cloud アカウント内のすべての AppRun アプリケーションを一覧表示します

利用可能なツール

ツール名	説明	必須パラメータ
`get_server_list`	すべてのサーバーのリストを取得します	なし
`get_server_info`	特定のサーバーに関する詳細情報を取得します	`serverId`
`get_switch_list`	すべてのスイッチのリストを取得します	なし
`get_switch_info`	特定のスイッチに関する詳細情報を取得します	`switchId`
`get_appliance_list`	すべてのアプライアンスのリストを取得します	なし
`get_appliance_info`	特定のアプライアンスに関する詳細情報を取得します	`applianceId`
`get_disk_list`	すべてのディスクのリストを取得します	なし
`get_disk_info`	特定のディスクに関する詳細情報を取得します	`diskId`
`get_archive_list`	すべてのアーカイブのリストを取得します	なし
`get_archive_info`	特定のアーカイブに関する詳細情報を取得します	`archiveId`
`get_cdrom_list`	すべてのISOイメージのリストを取得します	なし
`get_cdrom_info`	特定のISOイメージに関する詳細情報を取得します	`cdromId`
`get_bridge_list`	すべてのブリッジのリストを取得します	なし
`get_bridge_info`	特定の橋梁に関する詳細情報を取得します	`bridgeId`
`get_router_list`	すべてのルーターのリストを取得します	なし
`get_router_info`	特定のルータに関する詳細情報を取得します	`routerId`
`get_interface_list`	すべてのネットワークインターフェースのリストを取得します	なし
`get_interface_info`	特定のネットワークインターフェースに関する詳細情報を取得します	`interfaceId`
`get_icon_list`	すべてのアイコンのリストを取得します	なし
`get_icon_info`	特定のアイコンに関する詳細情報を取得します	`iconId`
`get_note_list`	すべてのメモと起動スクリプトのリストを取得します	なし
`get_note_info`	特定のメモまたは起動スクリプトに関する詳細情報を取得します	`noteId`
`get_sshkey_list`	すべてのSSHキーのリストを取得します	なし
`get_sshkey_info`	特定のSSHキーに関する詳細情報を取得します	`sshkeyId`
`get_region_list`	すべての地域のリストを取得します	なし
`get_region_info`	特定の地域に関する詳細情報を取得します	`regionId`
`get_zone_list`	すべてのゾーンのリストを取得します	なし
`get_zone_info`	特定のゾーンに関する詳細情報を取得します	`zoneId`
`get_product_info`	特定の製品に関する詳細情報を取得します	`productType`
`get_commonserviceitem_list`	すべての共通サービス項目のリストを取得します	なし
`get_commonserviceitem_info`	特定の共通サービス項目に関する詳細情報を取得します	`itemId`
`get_license_list`	すべてのライセンスのリストを取得します	なし
`get_license_info`	特定のライセンスに関する詳細情報を取得します	`licenseId`
`get_bill_info`	特定の月の請求情報を取得します	`year` 、 `month`
`get_bill_detail`	特定の月の詳細な請求情報を取得します	`year` 、 `month`
`get_coupon_info`	特定のクーポンに関する情報を取得します	`couponId`
`get_privatehost_info`	特定のプライベートホストに関する詳細情報を取得します	`privateHostId`
`get_public_price`	Sakura Cloud サービスの公開価格情報を取得します	なし
`get_apprun_list`	すべてのAppRunアプリケーションのリストを取得します	なし
`get_apprun_info`	特定のAppRunアプリケーションに関する詳細情報を取得します	`appId`
`create_apprun`	新しいAppRunアプリケーションを作成します	`name` 、 `dockerImage` 、 `planId`
`delete_apprun`	AppRunアプリケーションを削除します	`appId`
`start_apprun`	AppRunアプリケーションを起動します	`appId`
`stop_apprun`	AppRunアプリケーションを停止します	`appId`
`update_apprun`	既存のAppRunアプリケーションを更新します	`appId`
`get_apprun_logs`	AppRunアプリケーションからログを取得します	`appId`

AppRun統合

Sakura Cloud AppRunは、インフラストラクチャの管理なしにDockerコンテナを実行できるコンテナ化されたアプリケーションプラットフォームです。このMCPサーバーは、AppRunの完全な管理機能を提供します。

すべてのAppRunアプリケーションを表示
カスタム Docker イメージを使用して新しいアプリケーションを作成する
既存のアプリケーションを更新する (イメージ、構成などの変更)
アプリケーションの起動と停止
アプリケーションログを表示する
不要になったらアプリケーションを削除する

AppRun アプリケーションを作成または更新するときに、以下を指定できます。

アプリケーション名と説明
使用するDockerイメージ
プランID（割り当てられたリソースを決定）
キーと値のペアとしての環境変数

ゾーンサポート

すべてのAPI呼び出しは、特定のSakura Cloudデータセンターをターゲットとするゾーンパラメータの指定をサポートしています。デフォルトのゾーンはtk1v （東京）ですが、以下のように他のゾーンを指定することもできます。

is1a （石狩）
tk1a （東京）
さらに…

ゾーンパラメータを含むURIの例: sakura:///servers?zone=is1a

クロードとの統合

ClaudeデスクトップアプリはMCPサポートを提供します。このサーバーをClaudeと統合するには、以下の手順に従ってください。

サーバーがローカルまたはアクセス可能なホスト上で実行されていることを確認します。
OS に応じて適切な場所にclaude_desktop_config.jsonファイルを作成します。
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
ファイルに次の構成を追加します。

{
  "sacloud-server": {
    "command": "node",
    "args": ["path/to/mcp/dist/server.js"],
    "env": {
      "SACLOUD_API_TOKEN": "your_token_here",
      "SACLOUD_API_SECRET": "your_secret_here"
    }
  }
}

構成を適用するには、Claude デスクトップアプリを再起動します。
クロードとの会話で、Sakura Cloud のリソースとツールにアクセスできるようになりました。

セキュリティに関する考慮事項

このサーバーは機密性の高いAPI認証情報を処理します
APIトークンやシークレットをバージョン管理にコミットしないでください
すべての機密情報に環境変数を使用する
本番環境で適切なアクセス制御を実装する

ライセンス

ISC

Sakura Cloud MCP Server

Integrations