Sakura Cloud MCP 服务器

用于与 Sakura Cloud 的 API 交互的模型上下文协议 (MCP) 服务器实现。

什么是 MCP？

模型上下文协议 (MCP) 是一种标准化通信协议，使 AI 应用程序能够安全地与外部系统和数据源交互。它遵循客户端-服务器架构，其中 LLM 应用程序发起与服务器的连接，服务器会公开资源和工具。

概述

该项目实现了一个 MCP 服务器，允许 AI 助手通过标准化接口与 Sakura Cloud 基础设施进行交互。它使 AI 助手能够：

访问 Sakura Cloud 资源，如服务器、磁盘、网络等
使用工具列出资源并检索有关特定资源的详细信息
无需身份验证即可查询公开定价信息
管理 AppRun 容器化应用程序

先决条件

Node.js（v16 或更高版本）
Sakura Cloud API 凭证（令牌和密钥）
与 Claude 一起使用的 Claude 桌面应用程序（MCP 目前仅支持桌面应用程序）

安装

# 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

配置

设置以下环境变量：

SACLOUD_API_TOKEN ：您的 Sakura Cloud API 令牌
SACLOUD_API_SECRET ：您的 Sakura Cloud API 密钥

用法

可用资源

资源 URI	描述
`sakura:///servers`	列出您的 Sakura Cloud 帐户中的所有服务器
`sakura:///switches`	列出您的 Sakura Cloud 帐户中的所有交换机
`sakura:///appliances`	列出您的 Sakura Cloud 帐户中的所有设备
`sakura:///disks`	列出您的 Sakura Cloud 帐户中的所有磁盘
`sakura:///archives`	列出您的 Sakura Cloud 帐户中的所有档案
`sakura:///cdrom`	列出您的 Sakura Cloud 帐户中的所有 ISO 映像（CD-ROM）
`sakura:///bridge`	列出您的 Sakura Cloud 帐户中的所有桥接器
`sakura:///internet`	列出您的 Sakura Cloud 帐户中的所有路由器
`sakura:///interface`	列出您的 Sakura Cloud 帐户中的所有网络接口
`sakura:///icon`	列出您的 Sakura Cloud 帐户中的所有图标
`sakura:///note`	列出您的 Sakura Cloud 帐户中的所有启动脚本和注释
`sakura:///sshkey`	列出您的 Sakura Cloud 帐户中的所有 SSH 密钥
`sakura:///region`	列出您的 Sakura Cloud 帐户中的所有区域
`sakura:///zone`	列出您的 Sakura Cloud 帐户中的所有区域
`sakura:///product`	列出您的 Sakura Cloud 帐户中所有可用的产品
`sakura:///commonserviceitem`	列出您的 Sakura Cloud 帐户中的所有常用服务项目（DNS、简单监控等）
`sakura:///license`	列出您的 Sakura Cloud 帐户中的所有许可证
`sakura:///auth-status`	显示当前身份验证状态和权限
`sakura:///bill`	显示每月账单信息
`sakura:///bill-detail`	显示账单信息的详细分类
`sakura:///coupon`	列出所有可用的优惠券
`sakura:///privatehost`	列出您的 Sakura Cloud 帐户中的所有私有主机
`sakura:///public-price`	显示 Sakura Cloud 服务的公开定价信息（无需身份验证）
`sakura:///apprun`	列出您的 Sakura Cloud 帐户中的所有 AppRun 应用程序

可用工具

工具名称	描述	必需参数
`get_server_list`	检索所有服务器的列表	没有任何
`get_server_info`	检索有关特定服务器的详细信息	`serverId`
`get_switch_list`	检索所有交换机的列表	没有任何
`get_switch_info`	检索有关特定交换机的详细信息	`switchId`
`get_appliance_list`	检索所有电器的列表	没有任何
`get_appliance_info`	检索有关特定设备的详细信息	`applianceId`
`get_disk_list`	检索所有磁盘的列表	没有任何
`get_disk_info`	检索有关特定磁盘的详细信息	`diskId`
`get_archive_list`	检索所有档案的列表	没有任何
`get_archive_info`	检索有关特定档案的详细信息	`archiveId`
`get_cdrom_list`	检索所有 ISO 映像的列表	没有任何
`get_cdrom_info`	检索有关特定 ISO 映像的详细信息	`cdromId`
`get_bridge_list`	检索所有桥梁的列表	没有任何
`get_bridge_info`	检索有关特定桥梁的详细信息	`bridgeId`
`get_router_list`	检索所有路由器的列表	没有任何
`get_router_info`	检索有关特定路由器的详细信息	`routerId`
`get_interface_list`	检索所有网络接口的列表	没有任何
`get_interface_info`	检索有关特定网络接口的详细信息	`interfaceId`
`get_icon_list`	检索所有图标的列表	没有任何
`get_icon_info`	检索有关特定图标的详细信息	`iconId`
`get_note_list`	检索所有注释和启动脚本的列表	没有任何
`get_note_info`	检索有关特定注释或启动脚本的详细信息	`noteId`
`get_sshkey_list`	检索所有 SSH 密钥列表	没有任何
`get_sshkey_info`	检索有关特定 SSH 密钥的详细信息	`sshkeyId`
`get_region_list`	检索所有地区的列表	没有任何
`get_region_info`	检索特定区域的详细信息	`regionId`
`get_zone_list`	检索所有区域的列表	没有任何
`get_zone_info`	检索特定区域的详细信息	`zoneId`
`get_product_info`	检索有关特定产品的详细信息	`productType`
`get_commonserviceitem_list`	检索所有常见服务项目的列表	没有任何
`get_commonserviceitem_info`	检索有关特定常见服务项目的详细信息	`itemId`
`get_license_list`	检索所有许可证的列表	没有任何
`get_license_info`	检索有关特定许可证的详细信息	`licenseId`
`get_bill_info`	检索特定月份的账单信息	`year` 、 `month`
`get_bill_detail`	检索特定月份的详细账单信息	`year` 、 `month`
`get_coupon_info`	检索有关特定优惠券的信息	`couponId`
`get_privatehost_info`	检索特定私有主机的详细信息	`privateHostId`
`get_public_price`	检索 Sakura Cloud 服务的公开定价信息	没有任何
`get_apprun_list`	检索所有 AppRun 应用程序的列表	没有任何
`get_apprun_info`	检索有关特定 AppRun 应用程序的详细信息	`appId`
`create_apprun`	创建一个新的 AppRun 应用程序	`name` 、 `dockerImage` 、 `planId`
`delete_apprun`	删除 AppRun 应用程序	`appId`
`start_apprun`	启动 AppRun 应用程序	`appId`
`stop_apprun`	停止 AppRun 应用程序	`appId`
`update_apprun`	更新现有的 AppRun 应用程序	`appId`
`get_apprun_logs`	从 AppRun 应用程序获取日志	`appId`

AppRun 集成

Sakura Cloud AppRun 是一个容器化应用平台，允许您运行 Docker 容器，而无需管理基础架构。此 MCP 服务器提供完整的 AppRun 管理功能：

查看所有 AppRun 应用程序
使用自定义 Docker 镜像创建新的应用程序
更新现有应用程序（更改图像、配置等）
启动和停止应用程序
查看应用程序日志
删除不再需要的应用程序

创建或更新 AppRun 应用程序时，您可以指定：

应用程序名称和描述
要使用的 Docker 镜像
计划 ID（确定分配的资源）
环境变量作为键值对

区域支持

所有 API 调用都支持指定区域参数，以定位特定的 Sakura Cloud 数据中心。默认区域为tk1v （东京），但您可以指定其他区域，例如：

is1a （石狩）
tk1a （东京）
还有更多...

带有区域参数的示例 URI： sakura:///servers?zone=is1a

与克劳德整合

Claude 桌面应用程序提供 MCP 支持。请按照以下步骤将此服务器与 Claude 集成：

确保服务器在本地或可访问的主机上运行。
在适合您的操作系统的位置创建一个claude_desktop_config.json文件：
- Windows： %APPDATA%\Claude\claude_desktop_config.json
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux： ~/.config/Claude/claude_desktop_config.json
在文件中添加以下配置：

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

重新启动 Claude Desktop 应用程序以应用配置。
在与 Claude 的对话中，您现在可以访问 Sakura Cloud 资源和工具。

安全注意事项

该服务器处理敏感的 API 凭证
切勿将 API 令牌或机密提交到版本控制
对所有敏感信息使用环境变量
在生产中实施适当的访问控制

执照

国际学习中心

Sakura Cloud MCP Server

Integrations