Sakura Cloud

by hidenorigoto

9 stars
Not rated
GitHub

About

Enables management of Sakura Cloud infrastructure resources including servers, disks, networks, and containerized applications through natural language commands.

Details

Author
hidenorigoto
Repository
hidenorigoto/sacloud-mcp
GitHub stars
9
Categories
Productivity, Design, Developer Tools, AI, Project Management, Knowledge Base, Security
Tags
#integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Sakura Cloud
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 path/to/mcp/dist/server.js
    Environment
    • SACLOUD_API_TOKEN your_token_here
    • SACLOUD_API_SECRET your_secret_here

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

npm install

get_server_list

Retrieves list of all servers.

get_server_info

Retrieves detailed information about a specific server. Parameters: serverId.

get_switch_list

Retrieves list of all switches.

get_switch_info

Retrieves detailed information about a specific switch. Parameters: switchId.

get_appliance_list

Retrieves list of all appliances.

get_appliance_info

Retrieves detailed information about a specific appliance. Parameters: applianceId.

get_disk_list

Retrieves list of all disks.

get_disk_info

Retrieves detailed information about a specific disk. Parameters: diskId.

get_archive_list

Retrieves list of all archives.

get_archive_info

Retrieves detailed information about a specific archive. Parameters: archiveId.

get_cdrom_list

Retrieves list of all ISO images.

get_cdrom_info

Retrieves detailed information about a specific ISO image. Parameters: cdromId.

get_bridge_list

Retrieves list of all bridges.

get_bridge_info

Retrieves detailed information about a specific bridge. Parameters: bridgeId.

get_router_list

Retrieves list of all routers.

get_router_info

Retrieves detailed information about a specific router. Parameters: routerId.

get_interface_list

Retrieves list of all network interfaces.

get_interface_info

Retrieves detailed information about a specific network interface. Parameters: interfaceId.

get_icon_list

Retrieves list of all icons.

get_icon_info

Retrieves detailed information about a specific icon. Parameters: 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. Parameters: noteId.

get_sshkey_list

Retrieves list of all SSH keys.

get_sshkey_info

Retrieves detailed information about a specific SSH key. Parameters: sshkeyId.

get_region_list

Retrieves list of all regions.

get_region_info

Retrieves detailed information about a specific region. Parameters: regionId.

get_zone_list

Retrieves list of all zones.

get_zone_info

Retrieves detailed information about a specific zone. Parameters: zoneId.

get_product_info

Retrieves detailed information about specific product offerings. Parameters: productType.

get_commonserviceitem_list

Retrieves list of all common service items.

get_commonserviceitem_info

Retrieves detailed information about a specific common service item. Parameters: itemId.

get_license_list

Retrieves list of all licenses.

get_license_info

Retrieves detailed information about a specific license. Parameters: licenseId.

get_bill_info

Retrieves billing information for a specific month. Parameters: year, month.

get_bill_detail

Retrieves detailed billing information for a specific month. Parameters: year, month.

get_coupon_info

Retrieves information about a specific coupon. Parameters: couponId.

get_privatehost_info

Retrieves detailed information about a specific private host. Parameters: 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. Parameters: appId.

create_apprun

Creates a new AppRun application. Parameters: name, dockerImage, planId.

delete_apprun

Deletes an AppRun application. Parameters: appId.

start_apprun

Starts an AppRun application. Parameters: appId.

stop_apprun

Stops an AppRun application. Parameters: appId.

update_apprun

Updates an existing AppRun application. Parameters: appId.

get_apprun_logs

Gets logs from an AppRun application. Parameters: appId.

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

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

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.