sacloud/sacloud-mcp

概要

sacloud/sacloud-mcp 是一个面向 Sakura Cloud 的 MCP 服务器。

开发环境构建

必要工具

克隆项目

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

安装 uv

有关更详细的安装和使用方法，请参阅 uv 的文档。

curl -LsSf https://astral.sh/uv/install.sh | sh

同步环境构建

uv sync

将 MCP 安装到 LLM

将 MCP 安装到任意 LLM 中。 以下以 Claude Desktop 的配置为例。

在 Claude Desktop 的配置文件中添加以下内容。 注意，配置文件的位置因操作系统而异，如下所示：

• macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sacloud": {
      "command": "${HOME}/.local/bin/uv",
      "args": [
        "--directory",
        "<<MCPサーバーのルートディレクトリ>>/src",
        "run",
        "main.py"
      ],
      "env": {
        "<<環境変数1>>": "<<値をコピーしてここへ貼り付ける>>",
        "<<環境変数2>>": "<<値をコピーしてここへ貼り付ける>>"
      }
    }
  }
}

请参考以下内容，适当地替换由 <<>> 标记的元素。

• MCP 服务器的根目录

  • 例如: /Users/user/Source/sacloud-mcp

• 环境变量

  • 根据所使用的功能设置环境变量。

    • 若要访问 Sakura Cloud 资源，请参考 Sakura Cloud API 密钥进行替换。

      • "ACCESS_TOKEN": "<<复制值并粘贴到此处>>"

      • "ACCESS_TOKEN_SECRET": "<<复制值并粘贴到此处>>"

    • 若要访问 Sakura 对象存储，请参考 Sakura 对象存储 API 密钥进行替换。

      • "OBJECTSTORAGE_ACCESS_KEY_ID": "<<复制值并粘贴到此处>>"

      • "OBJECTSTORAGE_SECRET_ACCESS_KEY": "<<复制值并粘贴到此处>>"

测试

关于配置

tests/conftest.py 中定义了所有测试文件均可使用的 fixture， 无需在所有测试文件中显式 import 即可使用。

准备工作

由于需要从环境变量中获取认证信息，请在执行测试前设置 ACCESS_TOKEN 和 ACCESS_TOKEN_SECRET。

export ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxx
export ACCESS_TOKEN_SECRET=xxxxxxxxxxxxxxxxxxxx
export OBJECTSTORAGE_ACCESS_KEY_ID=xxxxxxxxxxxxxxxxxxxx
export OBJECTSTORAGE_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxx

执行测试

uv run pytest

许可证

sacloud-mcp 版权所有 (C) 2025- The sacloud/sacloud-mcp 作者。 本项目基于 Apache 2.0 许可证 发布。