Sakura Cloud MCP Server

Instructions

Implementation Reference

• src/server.ts:1660-1682 (handler)

  The handler logic for the 'get_cdrom_info' tool within the CallToolRequestSchema handler. It validates credentials, extracts the cdromId from arguments, calls the Sakura Cloud API to fetch specific CDROM info, and returns the JSON response.
  } else if (request.params.name === 'get_cdrom_info') { try { validateCredentials(); const cdromId = request.params.arguments?.cdromId as string; if (!cdromId) { throw new Error('ISO Image ID is required'); } const cdromInfo = await fetchFromSakuraCloud(`/cdrom/${cdromId}`); return { content: [ { type: 'text', text: JSON.stringify(cdromInfo, null, 2) } ] }; } catch (error) { console.error('Error calling tool:', error); throw error; }
• src/server.ts:896-907 (registration)

  Registration of the 'get_cdrom_info' tool in the ListToolsRequestSchema response, including name, description, and input schema definition.
  description: 'Get detailed information about a specific ISO image', inputSchema: { type: 'object', properties: { cdromId: { type: 'string', description: 'The ID of the ISO image to retrieve' } }, required: ['cdromId'] } },
• src/server.ts:898-907 (schema)

  Input schema definition for the 'get_cdrom_info' tool, specifying the required cdromId parameter.
  type: 'object', properties: { cdromId: { type: 'string', description: 'The ID of the ISO image to retrieve' } }, required: ['cdromId'] } },
• src/server.ts:20-72 (helper)

  Core helper function fetchFromSakuraCloud used by the get_cdrom_info handler to make authenticated HTTPS requests to the Sakura Cloud API endpoint `/cdrom/{cdromId}`.
  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 validateCredentials called by the handler to ensure API credentials are set before making requests.
  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.'); } }