Skip to main content
Glama
hidenorigoto

Sakura Cloud MCP Server

by hidenorigoto

Sakura Cloud MCP 服务器

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

什么是 MCP?

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

Related MCP server: human-mcp

概述

该项目实现了一个 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 集成:

  1. 确保服务器在本地或可访问的主机上运行。

  2. 在适合您的操作系统的位置创建一个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

  3. 在文件中添加以下配置:

{ "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. 重新启动 Claude Desktop 应用程序以应用配置。

  2. 在与 Claude 的对话中,您现在可以访问 Sakura Cloud 资源和工具。

安全注意事项

  • 该服务器处理敏感的 API 凭证

  • 切勿将 API 令牌或机密提交到版本控制

  • 对所有敏感信息使用环境变量

  • 在生产中实施适当的访问控制

执照

国际学习中心

Latest Blog Posts

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