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 Desktop 应用程序（目前仅支持在桌面应用中使用 MCP）

安装

bash

克隆仓库

git clone https://github.com/hidenorigoto/sacloud-mcp.git
cd sacloud-mcp

安装依赖

npm install

构建项目

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 集成

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

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

2. 在适合您的操作系统的相应位置创建一个 claude_desktop_config.json 文件：

   • Windows: %APPDATA%Claudeclaude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

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

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"
}
}
}

1. 重启 Claude 桌面应用程序以应用配置。

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

安全注意事项

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

许可证

ISC