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

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

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Available Tools

[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]

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:

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

Sakura Cloud