[!CAUTION] This project has been discontinued

This repository was archived on April 13, 2026.
This project is no longer maintained, and no further feature additions, bug fixes, or security updates will be provided.

New or continued use of this project is not recommended.

sacloud/sacloud-mcp

Overview

sacloud/sacloud-mcp is an MCP server for Sakura Cloud.

Related MCP server: Sakura Cloud MCP Server

Setting up the Development Environment

Required Tools

Cloning the Project

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

Installing uv

For more detailed installation and usage instructions, please refer to the uv documentation.

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

Synchronizing the Environment

uv sync

Installing the MCP to an LLM

Install the MCP to your preferred LLM. As an example, the configuration for Claude Desktop is shown below.

Add the following to the Claude Desktop configuration file. Note that the location of the configuration file depends on the OS as follows:

• 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>>": "<<値をコピーしてここへ貼り付ける>>"
      }
    }
  }
}

Replace the elements indicated by <<>> by referring to the following:

• Root directory of the MCP server

  • Example: /Users/user/Source/sacloud-mcp

• Environment variables

  • Set environment variables according to the features you use.

    • When accessing Sakura Cloud resources, refer to the Sakura Cloud API Key and replace accordingly.

      • "ACCESS_TOKEN": "<<Copy the value and paste it here>>"

      • "ACCESS_TOKEN_SECRET": "<<Copy the value and paste it here>>"

    • When accessing Sakura Object Storage, refer to the Sakura Object Storage API Key and replace accordingly.

      • "OBJECTSTORAGE_ACCESS_KEY_ID": "<<Copy the value and paste it here>>"

      • "OBJECTSTORAGE_SECRET_ACCESS_KEY": "<<Copy the value and paste it here>>"

Testing

About the Configuration

tests/conftest.py defines fixtures that can be used in all test files, and they can be used from all test files without explicit import.

Preparation

Since authentication information is retrieved from environment variables, set ACCESS_TOKEN and ACCESS_TOKEN_SECRET before running tests.

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

Running Tests

uv run pytest

License

sacloud-mcp Copyright (C) 2025- The sacloud/sacloud-mcp authors. This project is published under Apache 2.0 License.