home / mcp / kie.ai mcp server

Kie.ai MCP Server

Provides access to Kie.ai AI APIs for Nano Banana image generation/editing and Veo3 video generation with task tracking.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "andrewlwn77-kie-ai-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/kie-ai-mcp-server/dist/index.js"
      ],
      "env": {
        "KIE_AI_API_KEY": "YOUR_API_KEY",
        "KIE_AI_DB_PATH": "./tasks.db",
        "KIE_AI_TIMEOUT": "60000",
        "KIE_AI_BASE_URL": "https://api.kie.ai/api/v1"
      }
    }
  }
}

You can run a local MCP server that exposes Kie.ai AI APIs for image generation, image editing, and video generation. It manages tasks in a lightweight SQLite store, provides smart routing for task status, and handles errors robustly so you can build reliable AI media workflows from your MCP client.

How to use

Install and run the MCP server locally, then configure your MCP client to connect to it. You’ll use the server to request Nano Banana image generation, Nano Banana image edits, and Veo3 video generation. You can poll for task status, list recent tasks, and request a 1080p upgrade when available. Ensure your client passes prompts, image URLs, and optional parameters (such as aspect ratio or seeds) to guide generation and editing.

How to install

Prerequisites: install Node.js 18 or newer and obtain a Kie.ai API key.

From NPM Install the MCP server globally so you can run it as a command from anywhere.

From source, clone and build the project, then run the server locally.

Configuration and usage notes

Set your API key and optional base URL, timeouts, and database path to persist task records.

To connect your MCP client, provide the runtime command and environment for the server. You can run the server directly with Node or install it via npx for a quick setup.

Security and maintenance

Keep your API key secure and avoid committing it to version control. Monitor task status and clean up old records as needed. Consider rate limiting on the client side for high-volume usage and enable a 1080p upgrade only when required.

Troubleshooting tips

If you see unauthorized errors, verify your API key is correct. If you encounter task-not-found issues, check that the task IDs are valid and within the retention window. For generation failures, review prompt language and credit availability.

Available tools

generate_nano_banana

Generate images using Nano Banana with a text prompt.

edit_nano_banana

Edit existing images using a natural language prompt and up to 5 image URLs.

generate_veo3_video

Create Veo3 videos from a text prompt, with optional image input, model, aspect ratio, seeds, and watermark.

get_task_status

Check the status of a generation task by its ID.

list_tasks

List recent tasks with optional filtering by status and limit.

get_veo3_1080p_video

Retrieve a 1080p version of a Veo3 video for a given task.