Servidor MCP de Sakura Cloud

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para interactuar con la API de Sakura Cloud.

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un protocolo de comunicación estandarizado que permite a las aplicaciones de IA interactuar de forma segura con sistemas externos y fuentes de datos. Sigue una arquitectura cliente-servidor donde las aplicaciones LLM inician conexiones con servidores que exponen recursos y herramientas.

Descripción general

Este proyecto implementa un servidor MCP que permite a los asistentes de IA interactuar con la infraestructura de Sakura Cloud mediante una interfaz estandarizada. Permite a los asistentes de IA:

Acceda a recursos de Sakura Cloud como servidores, discos, redes y más
Utilice herramientas para enumerar recursos y recuperar información detallada sobre recursos específicos
Consultar información pública de precios sin requisitos de autenticación
Administrar aplicaciones en contenedores de AppRun

Prerrequisitos

Node.js (v16 o superior)
Credenciales de la API de Sakura Cloud (token y secreto)
Aplicación de escritorio de Claude para usar con Claude (MCP actualmente solo es compatible con la aplicación de escritorio)

Instalación

# Clone the repository
git clone https://github.com/hidenorigoto/sacloud-mcp.git
cd sacloud-mcp

# Install dependencies
npm install

# Build the project
npm run build

Configuración

Establezca las siguientes variables de entorno:

SACLOUD_API_TOKEN : Su token de API de Sakura Cloud
SACLOUD_API_SECRET : Su secreto de la API de Sakura Cloud

Uso

Recursos disponibles

URI del recurso	Descripción
`sakura:///servers`	Enumera todos los servidores en su cuenta de Sakura Cloud
`sakura:///switches`	Enumera todos los conmutadores en su cuenta de Sakura Cloud
`sakura:///appliances`	Enumera todos los dispositivos en su cuenta de Sakura Cloud
`sakura:///disks`	Enumera todos los discos en su cuenta de Sakura Cloud
`sakura:///archives`	Enumera todos los archivos en su cuenta de Sakura Cloud
`sakura:///cdrom`	Enumera todas las imágenes ISO (CD-ROM) en su cuenta de Sakura Cloud
`sakura:///bridge`	Enumera todos los puentes en su cuenta de Sakura Cloud
`sakura:///internet`	Enumera todos los enrutadores en su cuenta de Sakura Cloud
`sakura:///interface`	Enumera todas las interfaces de red en su cuenta de Sakura Cloud
`sakura:///icon`	Enumera todos los íconos en tu cuenta de Sakura Cloud
`sakura:///note`	Enumera todos los scripts y notas de inicio en su cuenta de Sakura Cloud
`sakura:///sshkey`	Enumera todas las claves SSH en su cuenta de Sakura Cloud
`sakura:///region`	Enumera todas las regiones en su cuenta de Sakura Cloud
`sakura:///zone`	Enumera todas las zonas de su cuenta de Sakura Cloud
`sakura:///product`	Enumera todos los productos disponibles en su cuenta de Sakura Cloud
`sakura:///commonserviceitem`	Enumera todos los elementos de servicio comunes (DNS, Simple Monitor, etc.) en su cuenta de Sakura Cloud
`sakura:///license`	Enumera todas las licencias en su cuenta de Sakura Cloud
`sakura:///auth-status`	Muestra el estado de autenticación y los permisos actuales
`sakura:///bill`	Muestra información de facturación mensual
`sakura:///bill-detail`	Muestra un desglose detallado de la información de facturación.
`sakura:///coupon`	Enumera todos los cupones disponibles
`sakura:///privatehost`	Enumera todos los hosts privados en su cuenta de Sakura Cloud
`sakura:///public-price`	Muestra información pública de precios de los servicios de Sakura Cloud (no se requiere autenticación)
`sakura:///apprun`	Enumera todas las aplicaciones AppRun en su cuenta de Sakura Cloud

Herramientas disponibles

Nombre de la herramienta	Descripción	Parámetros requeridos
`get_server_list`	Recupera la lista de todos los servidores	Ninguno
`get_server_info`	Recupera información detallada sobre un servidor específico	`serverId`
`get_switch_list`	Recupera la lista de todos los conmutadores	Ninguno
`get_switch_info`	Recupera información detallada sobre un conmutador específico	`switchId`
`get_appliance_list`	Recupera la lista de todos los electrodomésticos	Ninguno
`get_appliance_info`	Recupera información detallada sobre un dispositivo específico	`applianceId`
`get_disk_list`	Recupera la lista de todos los discos	Ninguno
`get_disk_info`	Recupera información detallada sobre un disco específico	`diskId`
`get_archive_list`	Recupera la lista de todos los archivos	Ninguno
`get_archive_info`	Recupera información detallada sobre un archivo específico	`archiveId`
`get_cdrom_list`	Recupera la lista de todas las imágenes ISO	Ninguno
`get_cdrom_info`	Recupera información detallada sobre una imagen ISO específica	`cdromId`
`get_bridge_list`	Recupera la lista de todos los puentes	Ninguno
`get_bridge_info`	Recupera información detallada sobre un puente específico	`bridgeId`
`get_router_list`	Recupera la lista de todos los enrutadores	Ninguno
`get_router_info`	Recupera información detallada sobre un enrutador específico	`routerId`
`get_interface_list`	Recupera la lista de todas las interfaces de red	Ninguno
`get_interface_info`	Recupera información detallada sobre una interfaz de red específica	`interfaceId`
`get_icon_list`	Recupera la lista de todos los iconos	Ninguno
`get_icon_info`	Recupera información detallada sobre un icono específico	`iconId`
`get_note_list`	Recupera la lista de todas las notas y scripts de inicio	Ninguno
`get_note_info`	Recupera información detallada sobre una nota específica o un script de inicio	`noteId`
`get_sshkey_list`	Recupera la lista de todas las claves SSH	Ninguno
`get_sshkey_info`	Recupera información detallada sobre una clave SSH específica	`sshkeyId`
`get_region_list`	Recupera la lista de todas las regiones	Ninguno
`get_region_info`	Recupera información detallada sobre una región específica	`regionId`
`get_zone_list`	Recupera la lista de todas las zonas	Ninguno
`get_zone_info`	Recupera información detallada sobre una zona específica	`zoneId`
`get_product_info`	Recupera información detallada sobre ofertas de productos específicos	`productType`
`get_commonserviceitem_list`	Recupera la lista de todos los elementos de servicio comunes	Ninguno
`get_commonserviceitem_info`	Recupera información detallada sobre un elemento de servicio común específico	`itemId`
`get_license_list`	Recupera la lista de todas las licencias	Ninguno
`get_license_info`	Recupera información detallada sobre una licencia específica	`licenseId`
`get_bill_info`	Recupera información de facturación de un mes específico	`year` , `month`
`get_bill_detail`	Recupera información de facturación detallada para un mes específico	`year` , `month`
`get_coupon_info`	Recupera información sobre un cupón específico	`couponId`
`get_privatehost_info`	Recupera información detallada sobre un host privado específico	`privateHostId`
`get_public_price`	Recupera información pública de precios para los servicios de Sakura Cloud	Ninguno
`get_apprun_list`	Recupera la lista de todas las aplicaciones AppRun	Ninguno
`get_apprun_info`	Recupera información detallada sobre una aplicación AppRun específica	`appId`
`create_apprun`	Crea una nueva aplicación AppRun	`name` , `dockerImage` , `planId`
`delete_apprun`	Elimina una aplicación AppRun	`appId`
`start_apprun`	Inicia una aplicación AppRun	`appId`
`stop_apprun`	Detiene una aplicación AppRun	`appId`
`update_apprun`	Actualiza una aplicación AppRun existente	`appId`
`get_apprun_logs`	Obtiene registros de una aplicación AppRun	`appId`

Integración de AppRun

Sakura Cloud AppRun es una plataforma de aplicaciones en contenedores que permite ejecutar contenedores Docker sin necesidad de administrar la infraestructura. Este servidor MCP ofrece funciones completas de gestión de AppRun:

Ver todas tus aplicaciones AppRun
Cree nuevas aplicaciones con imágenes Docker personalizadas
Actualizar aplicaciones existentes (cambiar imagen, configuración, etc.)
Iniciar y detener aplicaciones
Ver registros de aplicaciones
Eliminar aplicaciones cuando ya no sean necesarias

Al crear o actualizar una aplicación AppRun, puede especificar:

Nombre y descripción de la aplicación
Imagen de Docker para usar
Identificación del plan (determina los recursos asignados)
Variables de entorno como pares clave-valor

Soporte de zona

Todas las llamadas API permiten especificar un parámetro de zona para centros de datos específicos de Sakura Cloud. La zona predeterminada es tk1v (Tokio), pero se pueden especificar otras, como:

is1a (Ishikari)
tk1a (Tokio)
Y más...

Ejemplo de URI con parámetro de zona: sakura:///servers?zone=is1a

Integración con Claude

La aplicación Claude Desktop es compatible con MCP. Siga estos pasos para integrar este servidor con Claude:

Asegúrese de que el servidor esté ejecutándose localmente o en un host accesible.
Cree un archivo claude_desktop_config.json en la ubicación adecuada para su sistema operativo:
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Agregue la siguiente configuración al archivo:

{
  "sacloud-server": {
    "command": "node",
    "args": ["path/to/mcp/dist/server.js"],
    "env": {
      "SACLOUD_API_TOKEN": "your_token_here",
      "SACLOUD_API_SECRET": "your_secret_here"
    }
  }
}

Reinicie la aplicación Claude Desktop para aplicar la configuración.
En una conversación con Claude, ahora puedes acceder a los recursos y herramientas de Sakura Cloud.

Consideraciones de seguridad

Este servidor maneja credenciales API confidenciales
Nunca envíe tokens de API ni secretos al control de versiones
Utilice variables de entorno para toda la información confidencial
Implementar controles de acceso adecuados en la producción

Licencia

ISC

Sakura Cloud MCP Server

Integrations