MCP Kling

Instructions

Implementation Reference

• src/kling-client.ts:376-403 (handler)

  Core handler function in KlingClient that makes the API call to Kling AI's image generation endpoint, processes reference images if provided, and handles the request/response.
  async generateImage(request: ImageGenerationRequest): Promise<{ task_id: string }> { const path = '/v1/images/generation'; // Process reference image URL if provided const ref_image_url = await this.processImageUrl(request.ref_image_url); const body: any = { prompt: request.prompt, negative_prompt: request.negative_prompt || '', aspect_ratio: request.aspect_ratio || '1:1', num_images: request.num_images || 1, ...(ref_image_url && { ref_image_url }), ...(request.ref_image_weight && { ref_image_weight: request.ref_image_weight }), }; // Always add model_name body.model_name = request.model_name || 'kling-v2-master'; try { const response = await this.axiosInstance.post(path, body); return response.data.data; } catch (error) { if (axios.isAxiosError(error)) { throw new Error(`Kling API error: ${error.response?.data?.message || error.message}`); } throw error; } }
• src/index.ts:626-647 (handler)

  MCP server tool handler for 'generate_image' that validates and maps input arguments to ImageGenerationRequest, invokes KlingClient.generateImage, and formats the response with task ID.
  case 'generate_image': { const imageRequest: ImageGenerationRequest = { prompt: args.prompt as string, negative_prompt: args.negative_prompt as string | undefined, model_name: (args.model_name as 'kling-v1' | 'kling-v1.5' | 'kling-v1.6' | 'kling-v2-master' | undefined) || 'kling-v2-master', aspect_ratio: (args.aspect_ratio as '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '2:3' | '3:2') || '1:1', num_images: (args.num_images as number) || 1, ref_image_url: args.ref_image_url as string | undefined, ref_image_weight: (args.ref_image_weight as number) ?? 0.5, }; const result = await klingClient.generateImage(imageRequest); return { content: [ { type: 'text', text: `Image generation started successfully!\nTask ID: ${result.task_id}\n\nGenerating ${imageRequest.num_images} image(s) with aspect ratio ${imageRequest.aspect_ratio}.\nUse the check_image_status tool with this task ID to check the progress.`, }, ], }; }
• src/index.ts:328-370 (registration)

  Tool registration in the TOOLS array, defining name, description, and detailed inputSchema for the generate_image tool.
  name: 'generate_image', description: 'Generate images from text prompts using Kling AI. Create high-quality images with multiple aspect ratios and optional character reference support. Supports models v1, v1.5, and v2 with customizable parameters for creative control.', inputSchema: { type: 'object', properties: { prompt: { type: 'string', description: 'Text prompt describing the image to generate', }, negative_prompt: { type: 'string', description: 'Text describing what to avoid in the image (optional)', }, model_name: { type: 'string', enum: ['kling-v1', 'kling-v1.5', 'kling-v1.6', 'kling-v2-master'], description: 'Model version to use (default: kling-v2-master)', }, aspect_ratio: { type: 'string', enum: ['16:9', '9:16', '1:1', '4:3', '3:4', '2:3', '3:2'], description: 'Image aspect ratio (default: 1:1)', }, num_images: { type: 'number', description: 'Number of images to generate (default: 1)', minimum: 1, maximum: 4, }, ref_image_url: { type: 'string', description: 'Optional reference image URL for character consistency', }, ref_image_weight: { type: 'number', description: 'Weight of reference image influence (0-1, default: 0.5)', minimum: 0, maximum: 1, }, }, required: ['prompt'], }, },
• src/kling-client.ts:80-88 (schema)

  TypeScript interface defining the structure of ImageGenerationRequest used by the generateImage handler.
  export interface ImageGenerationRequest { prompt: string; negative_prompt?: string; model_name?: 'kling-v1' | 'kling-v1.5' | 'kling-v1.6' | 'kling-v2-master'; aspect_ratio?: '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '2:3' | '3:2'; num_images?: number; ref_image_url?: string; ref_image_weight?: number; }