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:

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

2. 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

3. 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"
    }
  }
}

4. Restart the Claude Desktop app to apply the configuration.

5. 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