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 目前仅支持桌面应用程序)
安装
配置
设置以下环境变量:
SACLOUD_API_TOKEN:您的 Sakura Cloud API 令牌SACLOUD_API_SECRET:您的 Sakura Cloud API 密钥
用法
可用资源
资源 URI | 描述 |
| 列出您的 Sakura Cloud 帐户中的所有服务器 |
| 列出您的 Sakura Cloud 帐户中的所有交换机 |
| 列出您的 Sakura Cloud 帐户中的所有设备 |
| 列出您的 Sakura Cloud 帐户中的所有磁盘 |
| 列出您的 Sakura Cloud 帐户中的所有档案 |
| 列出您的 Sakura Cloud 帐户中的所有 ISO 映像(CD-ROM) |
| 列出您的 Sakura Cloud 帐户中的所有桥接器 |
| 列出您的 Sakura Cloud 帐户中的所有路由器 |
| 列出您的 Sakura Cloud 帐户中的所有网络接口 |
| 列出您的 Sakura Cloud 帐户中的所有图标 |
| 列出您的 Sakura Cloud 帐户中的所有启动脚本和注释 |
| 列出您的 Sakura Cloud 帐户中的所有 SSH 密钥 |
| 列出您的 Sakura Cloud 帐户中的所有区域 |
| 列出您的 Sakura Cloud 帐户中的所有区域 |
| 列出您的 Sakura Cloud 帐户中所有可用的产品 |
| 列出您的 Sakura Cloud 帐户中的所有常用服务项目(DNS、简单监控等) |
| 列出您的 Sakura Cloud 帐户中的所有许可证 |
| 显示当前身份验证状态和权限 |
| 显示每月账单信息 |
| 显示账单信息的详细分类 |
| 列出所有可用的优惠券 |
| 列出您的 Sakura Cloud 帐户中的所有私有主机 |
| 显示 Sakura Cloud 服务的公开定价信息(无需身份验证) |
| 列出您的 Sakura Cloud 帐户中的所有 AppRun 应用程序 |
可用工具
工具名称 | 描述 | 必需参数 |
| 检索所有服务器的列表 | 没有任何 |
| 检索有关特定服务器的详细信息 |
|
| 检索所有交换机的列表 | 没有任何 |
| 检索有关特定交换机的详细信息 |
|
| 检索所有电器的列表 | 没有任何 |
| 检索有关特定设备的详细信息 |
|
| 检索所有磁盘的列表 | 没有任何 |
| 检索有关特定磁盘的详细信息 |
|
| 检索所有档案的列表 | 没有任何 |
| 检索有关特定档案的详细信息 |
|
| 检索所有 ISO 映像的列表 | 没有任何 |
| 检索有关特定 ISO 映像的详细信息 |
|
| 检索所有桥梁的列表 | 没有任何 |
| 检索有关特定桥梁的详细信息 |
|
| 检索所有路由器的列表 | 没有任何 |
| 检索有关特定路由器的详细信息 |
|
| 检索所有网络接口的列表 | 没有任何 |
| 检索有关特定网络接口的详细信息 |
|
| 检索所有图标的列表 | 没有任何 |
| 检索有关特定图标的详细信息 |
|
| 检索所有注释和启动脚本的列表 | 没有任何 |
| 检索有关特定注释或启动脚本的详细信息 |
|
| 检索所有 SSH 密钥列表 | 没有任何 |
| 检索有关特定 SSH 密钥的详细信息 |
|
| 检索所有地区的列表 | 没有任何 |
| 检索特定区域的详细信息 |
|
| 检索所有区域的列表 | 没有任何 |
| 检索特定区域的详细信息 |
|
| 检索有关特定产品的详细信息 |
|
| 检索所有常见服务项目的列表 | 没有任何 |
| 检索有关特定常见服务项目的详细信息 |
|
| 检索所有许可证的列表 | 没有任何 |
| 检索有关特定许可证的详细信息 |
|
| 检索特定月份的账单信息 |
、
|
| 检索特定月份的详细账单信息 |
、
|
| 检索有关特定优惠券的信息 |
|
| 检索特定私有主机的详细信息 |
|
| 检索 Sakura Cloud 服务的公开定价信息 | 没有任何 |
| 检索所有 AppRun 应用程序的列表 | 没有任何 |
| 检索有关特定 AppRun 应用程序的详细信息 |
|
| 创建一个新的 AppRun 应用程序 |
、
、
|
| 删除 AppRun 应用程序 |
|
| 启动 AppRun 应用程序 |
|
| 停止 AppRun 应用程序 |
|
| 更新现有的 AppRun 应用程序 |
|
| 从 AppRun 应用程序获取日志 |
|
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.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
在文件中添加以下配置:
重新启动 Claude Desktop 应用程序以应用配置。
在与 Claude 的对话中,您现在可以访问 Sakura Cloud 资源和工具。
安全注意事项
该服务器处理敏感的 API 凭证
切勿将 API 令牌或机密提交到版本控制
对所有敏感信息使用环境变量
在生产中实施适当的访问控制
执照
国际学习中心