Sakura Cloud MCP Server

樱花云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秘密

用法

可用资源

可用工具

AppRun集成

Sakura Cloud AppRun是一个容器化的应用程序平台，允许您在不管理基础设施的情况下运行Docker容器。此MCP服务器提供完整的AppRun管理功能：

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

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

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

区域支撑

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

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

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

与克劳德融合

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

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

1. 创建一个 claude_desktop_config.json 将文件放在操作系统的适当位置：

- 窗户： %APPDATA%\Claude\claude_desktop_config.json - macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json

1. 将以下配置添加到文件中：

{
  "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应用程序以应用配置。

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

安全考虑

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

许可证

国际协调委员会