MinIO Storage MCP

Instructions

Implementation Reference

• src/index.ts:574-592 (handler)

  Main handler for the 'download_files' MCP tool. Validates input parameters using Zod, invokes the MinIO client's downloadFiles method, and returns a formatted text response with batch operation results.

  case 'download_files': {
    const { bucketName, files } = z.object({
      bucketName: z.string(),
      files: z.array(z.object({
        objectName: z.string(),
        localPath: z.string()
      }))
    }).parse(args);
    
    const result = await this.minioClient.downloadFiles(bucketName, files);
    return {
      content: [
        {
          type: 'text',
          text: `批量下载完成: 成功 ${result.successCount} 个, 失败 ${result.failureCount} 个${result.errors.length > 0 ? '\n错误:\n' + result.errors.map(e => `- ${e.item}: ${e.error}`).join('\n') : ''}`
        }
      ]
    };
  }

• src/index.ts:255-277 (registration)

  Registration of the 'download_files' tool in the ListToolsRequestSchema handler, including name, description, and input schema definition.

  {
    name: 'download_files',
    description: '批量下载文件',
    inputSchema: {
      type: 'object',
      properties: {
        bucketName: { type: 'string', description: '存储桶名称' },
        files: {
          type: 'array',
          items: {
            type: 'object',
            properties: {
              objectName: { type: 'string', description: '对象名称' },
              localPath: { type: 'string', description: '本地保存路径' }
            },
            required: ['objectName', 'localPath']
          },
          description: '文件列表'
        }
      },
      required: ['bucketName', 'files']
    }
  },

• src/minio-client.ts:299-324 (helper)

  Core implementation of batch file downloads from MinIO bucket. Iterates over file list, calls individual downloadFile for each, tracks successes and failures using BatchOperationResult.

  async downloadFiles(bucketName: string, files: Array<{ objectName: string; localPath: string }>): Promise<BatchOperationResult> {
    this.ensureConnected();
    
    const result: BatchOperationResult = {
      success: true,
      successCount: 0,
      failureCount: 0,
      errors: []
    };
  
    for (const file of files) {
      try {
        await this.downloadFile(bucketName, file.objectName, file.localPath);
        result.successCount++;
      } catch (error) {
        result.success = false;
        result.failureCount++;
        result.errors.push({
          item: file.objectName,
          error: error instanceof Error ? error.message : String(error)
        });
      }
    }
  
    return result;
  }

• src/types.ts:44-52 (schema)

  Type definition for BatchOperationResult used in download_files response.

  export interface BatchOperationResult {
    success: boolean;
    successCount: number;
    failureCount: number;
    errors: Array<{
      item: string;
      error: string;
    }>;
  }