사쿠라 클라우드 MCP 서버

Sakura Cloud의 API와 상호작용하기 위한 MCP(Model Context Protocol) 서버 구현입니다.

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 AI 애플리케이션이 외부 시스템 및 데이터 소스와 안전하게 상호 작용할 수 있도록 하는 표준화된 통신 프로토콜입니다. 클라이언트-서버 아키텍처를 따르며, LLM 애플리케이션이 리소스와 도구를 제공하는 서버에 연결을 시작합니다.

개요

이 프로젝트는 AI 어시스턴트가 표준화된 인터페이스를 통해 Sakura Cloud 인프라와 상호 작용할 수 있도록 하는 MCP 서버를 구현합니다. 이를 통해 AI 어시스턴트는 다음과 같은 작업을 수행할 수 있습니다.

서버, 디스크, 네트워크 등 Sakura Cloud 리소스에 액세스하세요
도구를 사용하여 리소스를 나열하고 특정 리소스에 대한 자세한 정보를 검색합니다.
인증 요구 사항 없이 공개 가격 정보 쿼리
AppRun 컨테이너화된 애플리케이션 관리

필수 조건

Node.js(v16 이상)
Sakura Cloud API 자격 증명(토큰 및 비밀)
Claude와 함께 사용할 수 있는 Claude 데스크톱 앱(MCP는 현재 데스크톱 앱에서만 지원됨)

설치

지엑스피1

구성

다음 환경 변수를 설정하세요.

SACLOUD_API_TOKEN : Sakura Cloud API 토큰
SACLOUD_API_SECRET : Sakura Cloud API 비밀번호

용법

사용 가능한 리소스

리소스 URI	설명
`sakura:///servers`	Sakura Cloud 계정의 모든 서버를 나열합니다.
`sakura:///switches`	Sakura Cloud 계정의 모든 스위치를 나열합니다.
`sakura:///appliances`	Sakura Cloud 계정에 있는 모든 기기를 나열합니다.
`sakura:///disks`	Sakura Cloud 계정의 모든 디스크를 나열합니다.
`sakura:///archives`	Sakura Cloud 계정의 모든 아카이브를 나열합니다.
`sakura:///cdrom`	Sakura Cloud 계정에 있는 모든 ISO 이미지(CD-ROM)를 나열합니다.
`sakura:///bridge`	Sakura Cloud 계정의 모든 브리지를 나열합니다.
`sakura:///internet`	Sakura Cloud 계정의 모든 라우터를 나열합니다.
`sakura:///interface`	Sakura Cloud 계정의 모든 네트워크 인터페이스를 나열합니다.
`sakura:///icon`	Sakura Cloud 계정의 모든 아이콘을 나열합니다.
`sakura:///note`	Sakura Cloud 계정의 모든 시작 스크립트와 메모를 나열합니다.
`sakura:///sshkey`	Sakura Cloud 계정의 모든 SSH 키를 나열합니다.
`sakura:///region`	Sakura Cloud 계정의 모든 지역을 나열합니다.
`sakura:///zone`	Sakura Cloud 계정의 모든 영역을 나열합니다.
`sakura:///product`	Sakura Cloud 계정에서 사용 가능한 모든 제품을 나열합니다.
`sakura:///commonserviceitem`	Sakura Cloud 계정의 모든 일반 서비스 항목(DNS, Simple Monitor 등)을 나열합니다.
`sakura:///license`	Sakura Cloud 계정의 모든 라이선스를 나열합니다.
`sakura:///auth-status`	현재 인증 상태 및 권한을 표시합니다.
`sakura:///bill`	월별 청구 정보를 표시합니다
`sakura:///bill-detail`	청구 정보의 세부 내역을 보여줍니다.
`sakura:///coupon`	사용 가능한 모든 쿠폰을 나열합니다
`sakura:///privatehost`	Sakura Cloud 계정의 모든 개인 호스트를 나열합니다.
`sakura:///public-price`	Sakura Cloud 서비스에 대한 공개 가격 정보를 표시합니다(인증 필요 없음)
`sakura:///apprun`	Sakura Cloud 계정에 있는 모든 AppRun 애플리케이션을 나열합니다.

사용 가능한 도구

도구 이름	설명	필수 매개변수
`get_server_list`	모든 서버 목록을 검색합니다	없음
`get_server_info`	특정 서버에 대한 자세한 정보를 검색합니다	`serverId`
`get_switch_list`	모든 스위치 목록을 검색합니다	없음
`get_switch_info`	특정 스위치에 대한 자세한 정보를 검색합니다.	`switchId`
`get_appliance_list`	모든 기기 목록을 검색합니다	없음
`get_appliance_info`	특정 기기에 대한 자세한 정보를 검색합니다.	`applianceId`
`get_disk_list`	모든 디스크 목록을 검색합니다	없음
`get_disk_info`	특정 디스크에 대한 자세한 정보를 검색합니다.	`diskId`
`get_archive_list`	모든 아카이브 목록을 검색합니다	없음
`get_archive_info`	특정 아카이브에 대한 자세한 정보를 검색합니다.	`archiveId`
`get_cdrom_list`	모든 ISO 이미지 목록을 검색합니다.	없음
`get_cdrom_info`	특정 ISO 이미지에 대한 자세한 정보를 검색합니다.	`cdromId`
`get_bridge_list`	모든 브리지 목록을 검색합니다	없음
`get_bridge_info`	특정 브리지에 대한 자세한 정보를 검색합니다.	`bridgeId`
`get_router_list`	모든 라우터 목록을 검색합니다	없음
`get_router_info`	특정 라우터에 대한 자세한 정보를 검색합니다.	`routerId`
`get_interface_list`	모든 네트워크 인터페이스 목록을 검색합니다.	없음
`get_interface_info`	특정 네트워크 인터페이스에 대한 자세한 정보를 검색합니다.	`interfaceId`
`get_icon_list`	모든 아이콘 목록을 검색합니다	없음
`get_icon_info`	특정 아이콘에 대한 자세한 정보를 검색합니다.	`iconId`
`get_note_list`	모든 메모 및 시작 스크립트 목록을 검색합니다.	없음
`get_note_info`	특정 메모나 시작 스크립트에 대한 자세한 정보를 검색합니다.	`noteId`
`get_sshkey_list`	모든 SSH 키 목록을 검색합니다.	없음
`get_sshkey_info`	특정 SSH 키에 대한 자세한 정보를 검색합니다.	`sshkeyId`
`get_region_list`	모든 지역 목록을 검색합니다	없음
`get_region_info`	특정 지역에 대한 자세한 정보를 검색합니다	`regionId`
`get_zone_list`	모든 영역 목록을 검색합니다	없음
`get_zone_info`	특정 구역에 대한 자세한 정보를 검색합니다.	`zoneId`
`get_product_info`	특정 제품 제공에 대한 자세한 정보를 검색합니다.	`productType`
`get_commonserviceitem_list`	모든 일반 서비스 항목 목록을 검색합니다.	없음
`get_commonserviceitem_info`	특정 공통 서비스 항목에 대한 자세한 정보를 검색합니다.	`itemId`
`get_license_list`	모든 라이센스 목록을 검색합니다	없음
`get_license_info`	특정 라이센스에 대한 자세한 정보를 검색합니다.	`licenseId`
`get_bill_info`	특정 월의 청구 정보를 검색합니다.	`year` , `month`
`get_bill_detail`	특정 월에 대한 자세한 청구 정보를 검색합니다.	`year` , `month`
`get_coupon_info`	특정 쿠폰에 대한 정보를 검색합니다	`couponId`
`get_privatehost_info`	특정 개인 호스트에 대한 자세한 정보를 검색합니다.	`privateHostId`
`get_public_price`	Sakura Cloud 서비스에 대한 공개 가격 정보를 검색합니다.	없음
`get_apprun_list`	모든 AppRun 애플리케이션 목록을 검색합니다.	없음
`get_apprun_info`	특정 AppRun 애플리케이션에 대한 자세한 정보를 검색합니다.	`appId`
`create_apprun`	새로운 AppRun 애플리케이션을 만듭니다.	`name` , `dockerImage` , `planId`
`delete_apprun`	AppRun 애플리케이션을 삭제합니다	`appId`
`start_apprun`	AppRun 애플리케이션을 시작합니다	`appId`
`stop_apprun`	AppRun 애플리케이션을 중지합니다.	`appId`
`update_apprun`	기존 AppRun 애플리케이션을 업데이트합니다.	`appId`
`get_apprun_logs`	AppRun 애플리케이션에서 로그를 가져옵니다.	`appId`

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 Desktop 앱은 MCP 지원을 제공합니다. 이 서버를 Claude와 통합하려면 다음 단계를 따르세요.

서버가 로컬에서 실행 중인지 또는 접근 가능한 호스트에서 실행 중인지 확인하세요.
OS에 맞는 위치에 claude_desktop_config.json 파일을 만듭니다.
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- 리눅스: ~/.config/Claude/claude_desktop_config.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"
    }
  }
}

구성을 적용하려면 Claude Desktop 앱을 다시 시작하세요.
클로드와의 대화를 통해 이제 Sakura Cloud 리소스와 도구에 액세스할 수 있습니다.

보안 고려 사항

이 서버는 민감한 API 자격 증명을 처리합니다.
API 토큰이나 비밀을 버전 제어에 커밋하지 마십시오.
모든 민감한 정보에 환경 변수를 사용하세요
프로덕션에서 적절한 액세스 제어를 구현하세요

특허

아이에스씨

Sakura Cloud MCP Server

Integrations