playbooks

Home / MCP / Sakura Cloud MCP Server

Sakura Cloud MCP Server

An MCP server that lets you interact with Sakura Cloud resources, AppRun apps, and public pricing via standardized tools.

javascript
11stars
View on GitHub
Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
    "mcpServers": {
        "sacloud": {
            "command": "node",
            "args": [
                "path/to/mcp/dist/server.js"
            ],
            "env": {
                "SACLOUD_API_TOKEN": "YOUR_TOKEN_HERE",
                "SACLOUD_API_SECRET": "YOUR_SECRET_HERE"
            }
        }
    }
}

You can use this MCP server to securely interact with Sakura Cloud resources, AppRun applications, and pricing information through standardized, programmable endpoints. It enables your AI tools or clients to list resources, fetch detailed information, and manage AppRun deployments without manually navigating the Sakura Cloud UI.

How to use

Connect your MCP client to the Sakura Cloud MCP server to start listing resources, retrieving detailed information, and performing actions like managing AppRun applications. You can query resources such as servers, disks, networks, switches, and public pricing, then drill into a specific item to get its full details. Use the available tools to enumerate resources and fetch item-specific data, or invoke AppRun management commands to create, update, start, stop, or delete applications. You can also explore zone-scoped data by including a zone parameter in your requests to target specific Sakura Cloud data centers.

How to install

Prerequisites include having Node.js version 16 or higher and Sakura Cloud API credentials (token and secret). If you plan to integrate with Claude, you will also use the Claude Desktop app.

Step by step commands to set up the MCP server locally:

# 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
"}]}]},{

Additional content

Configuration and security practices are important when running this MCP server. Set sensitive values as environment variables and avoid committing tokens or secrets to version control. Use proper access controls in production environments.

AppRun integration lets you view, create, update, start, stop, and delete AppRun applications. You can specify application name, description, Docker image, plan ID, and environment variables when creating or updating an AppRun app.

Zone support applies to all API calls. You can target specific Sakura Cloud data centers by including a zone parameter, for example: sakura:///servers?zone=is1a. The default zone is tk1v (Tokyo), but you can specify others as needed.

Claude integration steps show how to configure the Claude Desktop app to run the MCP server locally. You place a configuration snippet in your Claude desktop config file, restart Claude Desktop, and then you can access Sakura Cloud resources from Claude conversations.

Available tools

get_server_list

Retrieves list of all servers in your Sakura Cloud account.

get_server_info

Retrieves detailed information about a specific server using serverId.

get_switch_list

Retrieves list of all switches.

get_switch_info

Retrieves detailed information about a specific switch using switchId.

get_appliance_list

Retrieves list of all appliances.

get_appliance_info

Retrieves detailed information about a specific appliance using applianceId.

get_disk_list

Retrieves list of all disks.

get_disk_info

Retrieves detailed information about a specific disk using diskId.

get_archive_list

Retrieves list of all archives.

get_archive_info

Retrieves detailed information about a specific archive using archiveId.

get_cdrom_list

Retrieves list of all ISO images.

get_cdrom_info

Retrieves detailed information about a specific ISO image using cdromId.

get_bridge_list

Retrieves list of all bridges.

get_bridge_info

Retrieves detailed information about a specific bridge using bridgeId.

get_router_list

Retrieves list of all routers.

get_router_info

Retrieves detailed information about a specific router using routerId.

get_interface_list

Retrieves list of all network interfaces.

get_interface_info

Retrieves detailed information about a specific network interface using interfaceId.

get_icon_list

Retrieves list of all icons.

get_icon_info

Retrieves detailed information about a specific icon using iconId.

get_note_list

Retrieves list of all notes and startup scripts.

get_note_info

Retrieves detailed information about a specific note or startup script using noteId.

get_sshkey_list

Retrieves list of all SSH keys.

get_sshkey_info

Retrieves detailed information about a specific SSH key using sshkeyId.

get_region_list

Retrieves list of all regions.

get_region_info

Retrieves detailed information about a specific region using regionId.

get_zone_list

Retrieves list of all zones.

get_zone_info

Retrieves detailed information about a specific zone using zoneId.

get_product_info

Retrieves detailed information about specific product offerings using productType.

get_commonserviceitem_list

Retrieves list of all common service items.

get_commonserviceitem_info

Retrieves detailed information about a specific item using itemId.

get_license_list

Retrieves list of all licenses.

get_license_info

Retrieves detailed information about a specific license using licenseId.

get_bill_info

Retrieves billing information for a specific month using year and month.

get_bill_detail

Retrieves detailed billing information for a specific month using year and month.

get_coupon_info

Retrieves information about a specific coupon using couponId.

get_privatehost_info

Retrieves detailed information about a specific private host using privateHostId.

get_public_price

Retrieves public pricing information for Sakura Cloud services.

get_apprun_list

Retrieves list of all AppRun applications.

get_apprun_info

Retrieves detailed information about a specific AppRun application using appId.

create_apprun

Creates a new AppRun application with name, Docker image, and planId.

delete_apprun

Deletes an AppRun application using appId.

start_apprun

Starts an AppRun application using appId.

stop_apprun

Stops an AppRun application using appId.

update_apprun

Updates an existing AppRun application using appId.

get_apprun_logs

Gets logs from an AppRun application using appId.