Hybris MCP Server

Instructions

Implementation Reference

• src/hybris-client.ts:727-762 (handler)

  The implementation of the getSystemInfo method, which executes a Groovy script to collect system information and parses the JSON response.

    async getSystemInfo(): Promise<Record<string, unknown>> {
      // Use Groovy script to get system info
      const script = `
  import de.hybris.platform.core.Registry
  import de.hybris.platform.util.Config
  
  def tenant = Registry.getCurrentTenant()
  def runtime = Runtime.getRuntime()
  
  def info = [
      hybrisVersion: Config.getString("build.version", "unknown"),
      buildNumber: Config.getString("build.number", "unknown"),
      tenantId: tenant.getTenantID(),
      clusterId: Config.getInt("cluster.id", 0),
      clusterIsland: Config.getInt("cluster.island.id", 0),
      javaVersion: System.getProperty("java.version"),
      javaVendor: System.getProperty("java.vendor"),
      osName: System.getProperty("os.name"),
      osArch: System.getProperty("os.arch"),
      maxMemoryMB: (runtime.maxMemory() / 1024 / 1024) as int,
      totalMemoryMB: (runtime.totalMemory() / 1024 / 1024) as int,
      freeMemoryMB: (runtime.freeMemory() / 1024 / 1024) as int,
      availableProcessors: runtime.availableProcessors()
  ]
  
  return groovy.json.JsonOutput.toJson(info)
  `;
      const result = await this.executeGroovyScript(script);
      try {
        // Parse the JSON result - executionResult contains the returned value
        const jsonStr = String(result.result || '');
        if (jsonStr && jsonStr.startsWith('{')) {
          return JSON.parse(jsonStr);
        }
        // If result is not JSON, return what we have
        return {

• src/index.ts:293-303 (registration)

  The definition and registration of the 'get_system_info' tool within the MCP tool list.

  {
    name: 'get_system_info',
    description: 'Get Hybris system information and health status',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },
  {
    name: 'trigger_catalog_sync',
    description: 'Trigger a catalog synchronization between versions',

• src/index.ts:458-460 (handler)

  The case statement handling the 'get_system_info' tool call by invoking the hybrisClient.getSystemInfo() method.

  case 'get_system_info':
    result = await hybrisClient.getSystemInfo();
    break;