Sakura Cloud MCP Server

Instructions

Implementation Reference

• src/server.ts:2121-2145 (handler)

  Handler function that executes the get_bill_info tool: validates input, calls fetchFromSakuraCloud with /bill/YYYYMM path, and returns JSON response.

  } else if (request.params.name === 'get_bill_info') {
    try {
      validateCredentials();
      
      const year = request.params.arguments?.year as string;
      const month = request.params.arguments?.month as string;
      
      if (!year || !month) {
        throw new Error('Year and month are required for billing information');
      }
      
      const billInfo = await fetchFromSakuraCloud(`/bill/${year}${month}`);
      
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(billInfo, null, 2)
          }
        ]
      };
    } catch (error) {
      console.error('Error calling tool:', error);
      throw error;
    }

• src/server.ts:1154-1170 (registration)

  Tool registration in ListToolsRequestSchema handler, defining name, description, and input schema.

    name: 'get_bill_info',
    description: 'Get billing information for a specific month',
    inputSchema: {
      type: 'object',
      properties: {
        year: {
          type: 'string',
          description: 'The year (YYYY) of the billing period'
        },
        month: {
          type: 'string',
          description: 'The month (MM) of the billing period'
        }
      },
      required: ['year', 'month']
    }
  },

• src/server.ts:1157-1169 (schema)

  Input schema definition for get_bill_info tool, specifying year and month as required string parameters.

    type: 'object',
    properties: {
      year: {
        type: 'string',
        description: 'The year (YYYY) of the billing period'
      },
      month: {
        type: 'string',
        description: 'The month (MM) of the billing period'
      }
    },
    required: ['year', 'month']
  }

• src/server.ts:20-72 (helper)

  Primary helper function for making HTTPS API requests to Sakura Cloud, used by get_bill_info handler.

  async function fetchFromSakuraCloud(path: string, isPublicAPI: boolean = false, zone: string = DEFAULT_ZONE, method: string = 'GET', bodyData?: any): Promise<any> {
    return new Promise((resolve, reject) => {
      const basePath = isPublicAPI ? '/cloud/api/cloud/1.1' : `/cloud/zone/${zone}/api/cloud/1.1`;
      
      const options = {
        hostname: 'secure.sakura.ad.jp',
        port: 443,
        path: `${basePath}${path}`,
        method: method,
        headers: {
          'Accept': 'application/json',
          'Authorization': '',
          'Content-Type': 'application/json'
        }
      };
      
      // Add authorization for non-public APIs
      if (!isPublicAPI) {
        options.headers['Authorization'] = `Basic ${Buffer.from(`${SACLOUD_API_TOKEN}:${SACLOUD_API_SECRET}`).toString('base64')}`;
      }
  
      const req = https.request(options, (res) => {
        let data = '';
        
        res.on('data', (chunk) => {
          data += chunk;
        });
        
        res.on('end', () => {
          try {
            if (data) {
              const parsedData = JSON.parse(data);
              resolve(parsedData);
            } else {
              resolve({});
            }
          } catch (err) {
            reject(new Error(`Failed to parse response: ${err}`));
          }
        });
      });
      
      req.on('error', (error) => {
        reject(error);
      });
      
      if (bodyData && (method === 'POST' || method === 'PUT')) {
        req.write(JSON.stringify(bodyData));
      }
      
      req.end();
    });
  }

• src/server.ts:125-129 (helper)

  Helper function to validate presence of Sakura Cloud API credentials, called in get_bill_info handler.

  function validateCredentials(): void {
    if (!SACLOUD_API_TOKEN || !SACLOUD_API_SECRET) {
      throw new Error('Missing API credentials. Set SACLOUD_API_TOKEN and SACLOUD_API_SECRET environment variables.');
    }
  }