sacloud/sacloud-mcp

Resumen

sacloud/sacloud-mcp es un servidor MCP para Sakura Cloud.

Configuración del entorno de desarrollo

Herramientas necesarias

Clonación del proyecto

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

Instalación de uv

Para obtener métodos de instalación y uso más detallados, consulte la documentación de uv.

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

Sincronización de la configuración del entorno

uv sync

Instalación de MCP en LLM

Instale MCP en el LLM de su elección. Como ejemplo, se muestra la configuración para Claude Desktop.

Añada lo siguiente al archivo de configuración de Claude Desktop. Tenga en cuenta que la ubicación del archivo de configuración varía según el sistema operativo:

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

Reemplace los elementos indicados con <<>> consultando lo siguiente:

• Directorio raíz del servidor MCP

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

• Variables de entorno

  • Configure las variables de entorno según las funciones que vaya a utilizar.

    • Si accede a recursos de Sakura Cloud, consulte la clave de API de Sakura Cloud para realizar el reemplazo.

      • "ACCESS_TOKEN": "<<copie el valor y péguelo aquí>>"

      • "ACCESS_TOKEN_SECRET": "<<copie el valor y péguelo aquí>>"

    • Si accede al almacenamiento de objetos de Sakura, consulte la clave de API del almacenamiento de objetos de Sakura para realizar el reemplazo.

      • "OBJECTSTORAGE_ACCESS_KEY_ID": "<<copie el valor y péguelo aquí>>"

      • "OBJECTSTORAGE_SECRET_ACCESS_KEY": "<<copie el valor y péguelo aquí>>"

Pruebas

Sobre la configuración

En tests/conftest.py se definen los fixtures disponibles para todos los archivos de prueba, los cuales pueden utilizarse desde cualquier archivo de prueba sin necesidad de una import explícita.

Preparación

Para obtener las credenciales de autenticación de las variables de entorno, configure ACCESS_TOKEN y ACCESS_TOKEN_SECRET antes de ejecutar las pruebas.

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

Ejecución de pruebas

uv run pytest

Licencia

sacloud-mcp Copyright (C) 2025- Los autores de sacloud/sacloud-mcp. Este proyecto se publica bajo la Licencia Apache 2.0.