Skip to main content
Glama
enesjakozh

Sakura Cloud MCP Server

by hidenorigoto
GitHub
JavaScript
11
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

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

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

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

An MCP server implementation that enables AI assistants to interact with and manage Sakura Cloud infrastructure, including servers, disks, networks, and containerized applications.

  1. What is MCP?
    1. Overview
      1. Prerequisites
        1. Installation
          1. Configuration
            1. Usage
              1. Available Resources
              2. Available Tools
            2. AppRun Integration
              1. Zone Support
                1. Integrating with Claude
                  1. Security Considerations
                    1. License

                      Related MCP Servers

                      • Vibe Coder MCP

                        freshtechbro
                        A
                        security
                        F
                        license
                        A
                        quality
                        An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.
                        Last updated -
                        11
                        1,117
                        79
                        • Linux
                        • Apple

                      • human-mcp

                        upamune
                        A
                        security
                        A
                        license
                        A
                        quality
                        An MCP server that allows AI assistants to utilize human capabilities by sending requests to humans and receiving their responses through a Streamlit UI.
                        Last updated -
                        7
                        44
                        MIT License

                      • FastFS-MCP

                        aj-geddes
                        -
                        security
                        F
                        license
                        -
                        quality
                        A high-speed MCP server that enables AI assistants like Claude to interact with local filesystems, manage Git repositories, and provide interactive experiences through a standardized JSON-based protocol.
                        Last updated -
                        5
                        • Apple

                      • Kiro MCP Memory

                        cbunting99
                        -
                        security
                        A
                        license
                        -
                        quality
                        An enhanced MCP server that provides intelligent memory and task management for AI assistants, featuring semantic search, automatic task extraction, and knowledge graphs to help manage development workflows.
                        Last updated -
                        17
                        MIT License
                        • Apple
                        • Linux

                      View all related MCP servers

                      New MCP Servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/hidenorigoto/sacloud-mcp'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server