Sakura Cloud MCP Server
The Sakura Cloud MCP Server enables AI assistants to interact with Sakura Cloud infrastructure through a standardized Model Context Protocol interface. With this server, you can:
Access and manage various resources (servers, disks, networks, switches, appliances, archives, ISO images, etc.)
Retrieve detailed information about specific resources
Query public pricing information without authentication
Manage AppRun containerized applications (create, update, start/stop, delete, view logs)
Handle billing information and view monthly breakdowns
Manage coupon information
Configure infrastructure components (SSH keys, icons, startup scripts)
Support multiple zones for targeting specific data centers
Check authentication status and permissions
Integrate with Claude Desktop app for conversational AI interactions
Enables management of Docker containers through the Sakura Cloud AppRun platform, allowing users to create, update, start, stop, and delete containerized applications with custom Docker images.
Uses Node.js as the runtime environment for the MCP server, with specific support for Node.js v16 or higher as a prerequisite for running the server.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sakura Cloud MCP Server list all my servers and show their current status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: k8s-mcp-server
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 buildConfiguration
Set the following environment variables:
SACLOUD_API_TOKEN: Your Sakura Cloud API tokenSACLOUD_API_SECRET: Your Sakura Cloud API secret
Usage
Available Resources
Resource URI | Description |
| Lists all servers in your Sakura Cloud account |
| Lists all switches in your Sakura Cloud account |
| Lists all appliances in your Sakura Cloud account |
| Lists all disks in your Sakura Cloud account |
| Lists all archives in your Sakura Cloud account |
| Lists all ISO images (CD-ROMs) in your Sakura Cloud account |
| Lists all bridges in your Sakura Cloud account |
| Lists all routers in your Sakura Cloud account |
| Lists all network interfaces in your Sakura Cloud account |
| Lists all icons in your Sakura Cloud account |
| Lists all startup scripts and notes in your Sakura Cloud account |
| Lists all SSH keys in your Sakura Cloud account |
| Lists all regions in your Sakura Cloud account |
| Lists all zones in your Sakura Cloud account |
| Lists all available products in your Sakura Cloud account |
| Lists all common service items (DNS, Simple Monitor, etc.) in your Sakura Cloud account |
| Lists all licenses in your Sakura Cloud account |
| Shows current authentication status and permissions |
| Shows monthly billing information |
| Shows detailed breakdown of billing information |
| Lists all available coupons |
| Lists all private hosts in your Sakura Cloud account |
| Shows public pricing information for Sakura Cloud services (no authentication required) |
| Lists all AppRun applications in your Sakura Cloud account |
Available Tools
Tool Name | Description | Required Parameters |
| Retrieves list of all servers | None |
| Retrieves detailed information about a specific server |
|
| Retrieves list of all switches | None |
| Retrieves detailed information about a specific switch |
|
| Retrieves list of all appliances | None |
| Retrieves detailed information about a specific appliance |
|
| Retrieves list of all disks | None |
| Retrieves detailed information about a specific disk |
|
| Retrieves list of all archives | None |
| Retrieves detailed information about a specific archive |
|
| Retrieves list of all ISO images | None |
| Retrieves detailed information about a specific ISO image |
|
| Retrieves list of all bridges | None |
| Retrieves detailed information about a specific bridge |
|
| Retrieves list of all routers | None |
| Retrieves detailed information about a specific router |
|
| Retrieves list of all network interfaces | None |
| Retrieves detailed information about a specific network interface |
|
| Retrieves list of all icons | None |
| Retrieves detailed information about a specific icon |
|
| Retrieves list of all notes and startup scripts | None |
| Retrieves detailed information about a specific note or startup script |
|
| Retrieves list of all SSH keys | None |
| Retrieves detailed information about a specific SSH key |
|
| Retrieves list of all regions | None |
| Retrieves detailed information about a specific region |
|
| Retrieves list of all zones | None |
| Retrieves detailed information about a specific zone |
|
| Retrieves detailed information about specific product offerings |
|
| Retrieves list of all common service items | None |
| Retrieves detailed information about a specific common service item |
|
| Retrieves list of all licenses | None |
| Retrieves detailed information about a specific license |
|
| Retrieves billing information for a specific month |
|
| Retrieves detailed billing information for a specific month |
|
| Retrieves information about a specific coupon |
|
| Retrieves detailed information about a specific private host |
|
| Retrieves public pricing information for Sakura Cloud services | None |
| Retrieves list of all AppRun applications | None |
| Retrieves detailed information about a specific AppRun application |
|
| Creates a new AppRun application |
|
| Deletes an AppRun application |
|
| Starts an AppRun application |
|
| Stops an AppRun application |
|
| Updates an existing AppRun application |
|
| Gets logs from an AppRun application |
|
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.jsonfile in the appropriate location for your OS:Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.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
Available Tools
46 toolscreate_apprunC
Create a new AppRun application
Inputs: name (required), dockerImage (required), planId (required), description, +2 more.
delete_apprunC
Delete an AppRun application
Inputs: appId (required), zone.
get_appliance_infoC
Get detailed information about a specific appliance
Inputs: applianceId (required).
get_appliance_listC
Get list of appliances
Inputs: zone.
get_apprun_infoC
Get detailed information about a specific AppRun application
Inputs: appId (required), zone.
get_apprun_listC
Get list of all AppRun applications
Inputs: zone.
get_apprun_logsC
Get logs from an AppRun application
Inputs: appId (required), offset, limit, zone.
get_archive_infoC
Get detailed information about a specific archive
Inputs: archiveId (required).
get_archive_listC
Get list of archives
Inputs: no named parameters.
get_bill_detailC
Get detailed billing information for a specific month
Inputs: year (required), month (required).
get_bill_infoC
Get billing information for a specific month
Inputs: year (required), month (required).
get_bridge_infoB
Get detailed information about a specific bridge
Inputs: bridgeId (required).
get_bridge_listC
Get list of bridges
Inputs: no named parameters.
get_cdrom_infoB
Get detailed information about a specific ISO image
Inputs: cdromId (required).
get_cdrom_listB
Get list of ISO images
Inputs: no named parameters.
get_commonserviceitem_infoC
Get detailed information about a specific common service item
Inputs: itemId (required).
get_commonserviceitem_listB
Get list of common service items (DNS, Simple Monitor, etc.)
Inputs: no named parameters.
get_coupon_infoC
Get information about a specific coupon
Inputs: couponId (required).
get_disk_infoB
Get detailed information about a specific disk
Inputs: diskId (required), zone.
get_disk_listC
Get list of disks
Inputs: zone.
get_icon_infoC
Get detailed information about a specific icon
Inputs: iconId (required).
get_icon_listC
Get list of icons
Inputs: no named parameters.
get_interface_infoC
Get detailed information about a specific network interface
Inputs: interfaceId (required).
get_interface_listB
Get list of network interfaces
Inputs: no named parameters.
get_license_infoC
Get detailed information about a specific license
Inputs: licenseId (required).
get_license_listC
Get list of licenses
Inputs: no named parameters.
get_note_infoC
Get detailed information about a specific note or startup script
Inputs: noteId (required).
get_note_listB
Get list of notes and startup scripts
Inputs: no named parameters.
get_privatehost_infoC
Get detailed information about a specific private host
Inputs: privateHostId (required).
get_product_infoC
Get detailed information about specific product offerings
Inputs: productType (required).
get_public_priceB
Get public pricing information for Sakura Cloud services
Inputs: no named parameters.
get_region_infoB
Get detailed information about a specific region
Inputs: regionId (required).
get_region_listC
Get list of regions
Inputs: no named parameters.
get_router_infoC
Get detailed information about a specific router
Inputs: routerId (required).
get_router_listC
Get list of routers
Inputs: no named parameters.
get_server_infoB
Get detailed information about a specific server
Inputs: serverId (required), zone.
get_server_listC
Get list of servers
Inputs: zone.
get_sshkey_infoB
Get detailed information about a specific SSH key
Inputs: sshkeyId (required).
get_sshkey_listB
Get list of SSH keys
Inputs: no named parameters.
get_switch_infoC
Get detailed information about a specific switch
Inputs: switchId (required), zone.
get_switch_listC
Get list of switches
Inputs: zone.
get_zone_infoC
Get detailed information about a specific zone
Inputs: zoneId (required).
get_zone_listC
Get list of zones
Inputs: no named parameters.
start_apprunC
Start an AppRun application
Inputs: appId (required), zone.
stop_apprunC
Stop an AppRun application
Inputs: appId (required), zone.
update_apprunC
Update an existing AppRun application
Inputs: appId (required), name, description, dockerImage, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 46 tools
Most tools are clearly distinct by resource type (e.g., disk, server, router) and action (get, create, delete), with minimal overlap. However, some tools like get_bill_detail and get_bill_info could be confused due to similar naming and purpose, and the AppRun tools (create, delete, update, start, stop) are well-separated but form a tight cluster that might require careful selection.
Tool names follow a highly consistent verb_noun pattern throughout, using snake_case uniformly. All tools start with verbs like 'get', 'create', 'delete', 'start', 'stop', or 'update', followed by a specific resource name, making them predictable and easy to parse.
With 46 tools, the count is excessive for a cloud management server, likely overwhelming for agents and indicating poor scoping. While Sakura Cloud has many resource types, the server could benefit from consolidation or categorization to reduce cognitive load and improve usability.
The tool set provides comprehensive coverage for Sakura Cloud's domain, including CRUD operations for key resources like AppRun and extensive 'get' functions for various cloud components (servers, disks, networks, billing, etc.). Minor gaps exist, such as missing update/delete operations for many resources beyond AppRun, but core workflows are well-supported.
Maintenance
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
AlicenseBqualityFmaintenanceAn MCP server for Sakura Cloud that enables interaction with cloud resources and object storage. It allows users to manage Sakura Cloud infrastructure through natural language interfaces using the Model Context Protocol.415Apache 2.0- AlicenseNot gradedqualityDmaintenanceAn MCP server that lets AI assistants safely inspect and operate on Kubernetes clusters through natural conversation.MIT
- AlicenseNot gradedqualityBmaintenanceA plugin-based MCP server that enables AI assistants to interact with external systems through custom tools, resources, and prompts.4AGPL 3.0
- AlicenseBqualityCmaintenanceAn MCP server for managing Azure infrastructure from AI assistants, supporting subscriptions, VMs, storage, networking, identity, and more through natural language commands.992MIT