Sakura Cloud MCP Server

A Model Context Protocol (MCP) server implementation for interacting with Sakura Cloud's API.

What is MCP?

The Model Context Protocol (MCP) is a standardized communication protocol that enables AI applications to securely interact with external systems and data sources. It follows a client-server architecture where LLM applications initiate connections to servers that expose resources and tools.

Overview

This project implements an MCP server that allows AI assistants to interact with Sakura Cloud infrastructure through a standardized interface. It enables AI assistants to:

Access Sakura Cloud resources like servers, disks, networks, and more
Use tools to list resources and retrieve detailed information about specific resources
Query public pricing information without authentication requirements
Manage AppRun containerized applications

Prerequisites

Node.js (v16 or higher)
Sakura Cloud API credentials (token and secret)
Claude Desktop app for using with Claude (MCP is currently only supported in the desktop app)

Installation

# 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

Configuration

Set the following environment variables:

SACLOUD_API_TOKEN: Your Sakura Cloud API token
SACLOUD_API_SECRET: Your Sakura Cloud API secret

Usage

Available Resources

Resource URI	Description
`sakura:///servers`	Lists all servers in your Sakura Cloud account
`sakura:///switches`	Lists all switches in your Sakura Cloud account
`sakura:///appliances`	Lists all appliances in your Sakura Cloud account
`sakura:///disks`	Lists all disks in your Sakura Cloud account
`sakura:///archives`	Lists all archives in your Sakura Cloud account
`sakura:///cdrom`	Lists all ISO images (CD-ROMs) in your Sakura Cloud account
`sakura:///bridge`	Lists all bridges in your Sakura Cloud account
`sakura:///internet`	Lists all routers in your Sakura Cloud account
`sakura:///interface`	Lists all network interfaces in your Sakura Cloud account
`sakura:///icon`	Lists all icons in your Sakura Cloud account
`sakura:///note`	Lists all startup scripts and notes in your Sakura Cloud account
`sakura:///sshkey`	Lists all SSH keys in your Sakura Cloud account
`sakura:///region`	Lists all regions in your Sakura Cloud account
`sakura:///zone`	Lists all zones in your Sakura Cloud account
`sakura:///product`	Lists all available products in your Sakura Cloud account
`sakura:///commonserviceitem`	Lists all common service items (DNS, Simple Monitor, etc.) in your Sakura Cloud account
`sakura:///license`	Lists all licenses in your Sakura Cloud account
`sakura:///auth-status`	Shows current authentication status and permissions
`sakura:///bill`	Shows monthly billing information
`sakura:///bill-detail`	Shows detailed breakdown of billing information
`sakura:///coupon`	Lists all available coupons
`sakura:///privatehost`	Lists all private hosts in your Sakura Cloud account
`sakura:///public-price`	Shows public pricing information for Sakura Cloud services (no authentication required)
`sakura:///apprun`	Lists all AppRun applications in your Sakura Cloud account

Available Tools

Tool Name	Description	Required Parameters
`get_server_list`	Retrieves list of all servers	None
`get_server_info`	Retrieves detailed information about a specific server	`serverId`
`get_switch_list`	Retrieves list of all switches	None
`get_switch_info`	Retrieves detailed information about a specific switch	`switchId`
`get_appliance_list`	Retrieves list of all appliances	None
`get_appliance_info`	Retrieves detailed information about a specific appliance	`applianceId`
`get_disk_list`	Retrieves list of all disks	None
`get_disk_info`	Retrieves detailed information about a specific disk	`diskId`
`get_archive_list`	Retrieves list of all archives	None
`get_archive_info`	Retrieves detailed information about a specific archive	`archiveId`
`get_cdrom_list`	Retrieves list of all ISO images	None
`get_cdrom_info`	Retrieves detailed information about a specific ISO image	`cdromId`
`get_bridge_list`	Retrieves list of all bridges	None
`get_bridge_info`	Retrieves detailed information about a specific bridge	`bridgeId`
`get_router_list`	Retrieves list of all routers	None
`get_router_info`	Retrieves detailed information about a specific router	`routerId`
`get_interface_list`	Retrieves list of all network interfaces	None
`get_interface_info`	Retrieves detailed information about a specific network interface	`interfaceId`
`get_icon_list`	Retrieves list of all icons	None
`get_icon_info`	Retrieves detailed information about a specific icon	`iconId`
`get_note_list`	Retrieves list of all notes and startup scripts	None
`get_note_info`	Retrieves detailed information about a specific note or startup script	`noteId`
`get_sshkey_list`	Retrieves list of all SSH keys	None
`get_sshkey_info`	Retrieves detailed information about a specific SSH key	`sshkeyId`
`get_region_list`	Retrieves list of all regions	None
`get_region_info`	Retrieves detailed information about a specific region	`regionId`
`get_zone_list`	Retrieves list of all zones	None
`get_zone_info`	Retrieves detailed information about a specific zone	`zoneId`
`get_product_info`	Retrieves detailed information about specific product offerings	`productType`
`get_commonserviceitem_list`	Retrieves list of all common service items	None
`get_commonserviceitem_info`	Retrieves detailed information about a specific common service item	`itemId`
`get_license_list`	Retrieves list of all licenses	None
`get_license_info`	Retrieves detailed information about a specific license	`licenseId`
`get_bill_info`	Retrieves billing information for a specific month	`year`, `month`
`get_bill_detail`	Retrieves detailed billing information for a specific month	`year`, `month`
`get_coupon_info`	Retrieves information about a specific coupon	`couponId`
`get_privatehost_info`	Retrieves detailed information about a specific private host	`privateHostId`
`get_public_price`	Retrieves public pricing information for Sakura Cloud services	None
`get_apprun_list`	Retrieves list of all AppRun applications	None
`get_apprun_info`	Retrieves detailed information about a specific AppRun application	`appId`
`create_apprun`	Creates a new AppRun application	`name`, `dockerImage`, `planId`
`delete_apprun`	Deletes an AppRun application	`appId`
`start_apprun`	Starts an AppRun application	`appId`
`stop_apprun`	Stops an AppRun application	`appId`
`update_apprun`	Updates an existing AppRun application	`appId`
`get_apprun_logs`	Gets logs from an AppRun application	`appId`

AppRun Integration

Sakura Cloud AppRun is a containerized application platform that allows you to run Docker containers without managing infrastructure. This MCP server provides full AppRun management capabilities:

View all your AppRun applications
Create new applications with custom Docker images
Update existing applications (change image, configuration, etc.)
Start and stop applications
View application logs
Delete applications when no longer needed

When creating or updating an AppRun application, you can specify:

Application name and description
Docker image to use
Plan ID (determines resources allocated)
Environment variables as key-value pairs

Zone Support

All API calls support specifying a zone parameter to target specific Sakura Cloud data centers. The default zone is tk1v (Tokyo), but you can specify others such as:

is1a (Ishikari)
tk1a (Tokyo)
And more...

Example URI with zone parameter: sakura:///servers?zone=is1a

Integrating with Claude

Claude Desktop app provides MCP support. Follow these steps to integrate this server with Claude:

Make sure the server is running locally or on an accessible host.
Create a claude_desktop_config.json file in the appropriate location for your OS:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Add the following configuration to the file:

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

Restart the Claude Desktop app to apply the configuration.
In a conversation with Claude, you can now access Sakura Cloud resources and tools.

Security Considerations

This server handles sensitive API credentials
Never commit API tokens or secrets to version control
Use environment variables for all sensitive information
Implement proper access controls in production

License

ISC

Overview

This project implements an MCP server that allows AI assistants to interact with Sakura Cloud infrastructure through a standardized interface. It enables AI assistants to:

Access Sakura Cloud resources like servers, disks, networks, and more

Use tools to list resources and retrieve detailed information about specific resources

Query public pricing information without authentication requirements

Manage AppRun containerized applications

Usage

Available Resources

Resource URI

Description

sakura:///servers

Lists all servers in your Sakura Cloud account

sakura:///switches

Lists all switches in your Sakura Cloud account

sakura:///appliances

Lists all appliances in your Sakura Cloud account

sakura:///disks

Lists all disks in your Sakura Cloud account

sakura:///archives

Lists all archives in your Sakura Cloud account

sakura:///cdrom

Lists all ISO images (CD-ROMs) in your Sakura Cloud account

sakura:///bridge

Lists all bridges in your Sakura Cloud account

sakura:///internet

Lists all routers in your Sakura Cloud account

sakura:///interface

Lists all network interfaces in your Sakura Cloud account

sakura:///icon

Lists all icons in your Sakura Cloud account

sakura:///note

Lists all startup scripts and notes in your Sakura Cloud account

sakura:///sshkey

Lists all SSH keys in your Sakura Cloud account

sakura:///region

Lists all regions in your Sakura Cloud account

sakura:///zone

Lists all zones in your Sakura Cloud account

sakura:///product

Lists all available products in your Sakura Cloud account

sakura:///commonserviceitem

Lists all common service items (DNS, Simple Monitor, etc.) in your Sakura Cloud account

sakura:///license

Lists all licenses in your Sakura Cloud account

sakura:///auth-status

Shows current authentication status and permissions

sakura:///bill

Shows monthly billing information

sakura:///bill-detail

Shows detailed breakdown of billing information

sakura:///coupon

Lists all available coupons

sakura:///privatehost

Lists all private hosts in your Sakura Cloud account

sakura:///public-price

Shows public pricing information for Sakura Cloud services (no authentication required)

sakura:///apprun

Lists all AppRun applications in your Sakura Cloud account

Available Tools

Tool Name

Description

Required Parameters

get_server_list

Retrieves list of all servers

None

get_server_info

Retrieves detailed information about a specific server

serverId

get_switch_list

Retrieves list of all switches

None

get_switch_info

Retrieves detailed information about a specific switch

switchId

get_appliance_list

Retrieves list of all appliances

None

get_appliance_info

Retrieves detailed information about a specific appliance

applianceId

get_disk_list

Retrieves list of all disks

None

get_disk_info

Retrieves detailed information about a specific disk

diskId

get_archive_list

Retrieves list of all archives

None

get_archive_info

Retrieves detailed information about a specific archive

archiveId

get_cdrom_list

Retrieves list of all ISO images

None

get_cdrom_info

Retrieves detailed information about a specific ISO image

cdromId

get_bridge_list

Retrieves list of all bridges

None

get_bridge_info

Retrieves detailed information about a specific bridge

bridgeId

get_router_list

Retrieves list of all routers

None

get_router_info

Retrieves detailed information about a specific router

routerId

get_interface_list

Retrieves list of all network interfaces

None

get_interface_info

Retrieves detailed information about a specific network interface

interfaceId

get_icon_list

Retrieves list of all icons

None

get_icon_info

Retrieves detailed information about a specific icon

iconId

get_note_list

Retrieves list of all notes and startup scripts

None

get_note_info

Retrieves detailed information about a specific note or startup script

noteId

get_sshkey_list

Retrieves list of all SSH keys

None

get_sshkey_info

Retrieves detailed information about a specific SSH key

sshkeyId

get_region_list

Retrieves list of all regions

None

get_region_info

Retrieves detailed information about a specific region

regionId

get_zone_list

Retrieves list of all zones

None

get_zone_info

Retrieves detailed information about a specific zone

zoneId

get_product_info

Retrieves detailed information about specific product offerings

productType

get_commonserviceitem_list

Retrieves list of all common service items

None

get_commonserviceitem_info

Retrieves detailed information about a specific common service item

itemId

get_license_list

Retrieves list of all licenses

None

get_license_info

Retrieves detailed information about a specific license

licenseId

get_bill_info

Retrieves billing information for a specific month

year, month

get_bill_detail

Retrieves detailed billing information for a specific month

year, month

get_coupon_info

Retrieves information about a specific coupon

couponId

get_privatehost_info

Retrieves detailed information about a specific private host

privateHostId

get_public_price

Retrieves public pricing information for Sakura Cloud services

None

get_apprun_list

Retrieves list of all AppRun applications

None

get_apprun_info

Retrieves detailed information about a specific AppRun application

appId

create_apprun

Creates a new AppRun application

name, dockerImage, planId

delete_apprun

Deletes an AppRun application

appId

start_apprun

Starts an AppRun application

appId

stop_apprun

Stops an AppRun application

appId

update_apprun

Updates an existing AppRun application

appId

get_apprun_logs

Gets logs from an AppRun application

appId

AppRun Integration

Sakura Cloud AppRun is a containerized application platform that allows you to run Docker containers without managing infrastructure. This MCP server provides full AppRun management capabilities:

View all your AppRun applications

Create new applications with custom Docker images

Update existing applications (change image, configuration, etc.)

Start and stop applications

View application logs

Delete applications when no longer needed

When creating or updating an AppRun application, you can specify:

Application name and description

Docker image to use

Plan ID (determines resources allocated)

Environment variables as key-value pairs

Integrating with Claude

Claude Desktop app provides MCP support. Follow these steps to integrate this server with Claude:

Make sure the server is running locally or on an accessible host.

Create a claude_desktop_config.json file in the appropriate location for your OS:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Add the following configuration to the file:

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

Restart the Claude Desktop app to apply the configuration.

In a conversation with Claude, you can now access Sakura Cloud resources and tools.