sacloud/sacloud-mcp

개요

sacloud/sacloud-mcp는 사쿠라 클라우드용 MCP 서버입니다.

개발 환경 구축

필수 도구

프로젝트 클론

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

uv 설치

더 자세한 설치 방법 및 사용 방법은 uv의 문서를 참조하십시오.

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

환경 구축 동기화

uv sync

LLM에 MCP 설치

임의의 LLM에 MCP를 설치합니다. 일례로 Claude Desktop에서의 설정을 설명합니다.

Claude Desktop 설정 파일에 다음을 추가합니다. 참고로, 설정 파일의 위치는 OS별로 다음과 같습니다.

• 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

• 환경 변수

  • 사용하는 기능에 따라 환경 변수를 설정합니다.

    • 사쿠라 클라우드 리소스에 액세스하는 경우, 사쿠라 클라우드 API 키를 참조하여 교체하십시오.

      • "ACCESS_TOKEN": "<<값을 복사하여 여기에 붙여넣기>>"

      • "ACCESS_TOKEN_SECRET": "<<값을 복사하여 여기에 붙여넣기>>"

    • 사쿠라 오브젝트 스토리지에 액세스하는 경우, 사쿠라 오브젝트 스토리지 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

License

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