Kie.AI MCP Server

Kie.ai MCP服务器

MCP（模型上下文协议）服务器，提供对Kie.ai的ai API的访问，包括Nano Banana图像生成/编辑和Veo3视频生成。

特性

• 纳米香蕉图像生成：使用谷歌的Gemini 2.5 Flash图像预览生成文本到图像
• 纳米香蕉图像编辑：自然语言图像编辑，最多可输入5张图像
• 视频生成：具有文本到视频和图像到视频功能的专业质量视频生成
• 1080p视频升级：获取Veo3视频的高清版本
• 任务管理：基于SQLite的任务跟踪和状态轮询
• 智能端点路由：自动检测任务类型以进行状态检查
• 错误处理：全面的错误处理和验证

先决条件

• Node.js 18+
• Kie.ai API密钥来自https://kie.ai/api-key

安装

来自NPM

npm install -g @andrewlwn77/kie-ai-mcp-server

来源

# Clone the repository
git clone https://github.com/andrewlwn77/kie-ai-mcp-server.git
cd kie-ai-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

配置

环境变量

# Required
export KIE_AI_API_KEY="your-api-key-here"

# Optional
export KIE_AI_BASE_URL="https://api.kie.ai/api/v1"  # Default
export KIE_AI_TIMEOUT="60000"                      # Default: 60 seconds
export KIE_AI_DB_PATH="./tasks.db"                 # Default: ./tasks.db

MCP配置

添加到您的Claude Desktop或MCP客户端配置中：

{
  "kie-ai-mcp-server": {
    "command": "node",
    "args": ["/path/to/kie-ai-mcp-server/dist/index.js"],
    "env": {
      "KIE_AI_API_KEY": "your-api-key-here"
    }
  }
}

或者，如果全局安装：

{
  "kie-ai-mcp-server": {
    "command": "npx",
    "args": ["-y", "@andrewlwn77/kie-ai-mcp-server"],
    "env": {
      "KIE_AI_API_KEY": "your-api-key-here"
    }
  }
}

可用工具

1. generate_nano_banana

使用Nano Banana生成图像。

参数：

• prompt （string，必填）：要生成的图像的文本描述

例子：

{
  "prompt": "A surreal painting of a giant banana floating in space"
}

2. edit_nano_banana

使用自然语言提示编辑图像。

参数：

• prompt （字符串，必填）：要进行的编辑的描述
• image_urls （数组，必填）：要编辑的图像的URL（最多5个）

例子：

{
  "prompt": "Add a rainbow arching over the mountains",
  "image_urls": ["https://example.com/image.jpg"]
}

3. generate_veo3_video

使用Veo3生成视频。

参数：

• prompt （字符串，必填）：视频描述
• imageUrls （数组，可选）：图像到视频的图像（最多1个）
• model （枚举，可选）：“veo3”或“veo3_fast”（默认值：“veo3”）
• aspectRatio （枚举，可选）：“16:9”或“9:16”（默认值：“16:8”）
• seeds （整数，可选）：随机种子10000-99999
• watermark （字符串，可选）：水印文本
• enableFallback （布尔值，可选）：启用回退机制

例子：

{
  "prompt": "A dog playing in a park",
  "model": "veo3",
  "aspectRatio": "16:9",
  "seeds": 12345
}

4. get_task_status

检查生成任务的状态。

参数：

• task_id （字符串，必填）：要检查的任务ID

5. list_tasks

列出最近的任务及其状态。

参数：

• limit （整数，可选）：要返回的最大任务数（默认值：20，最大值：100）
• status （字符串，可选）：按状态筛选（“待定”、“正在处理”、“已完成”、“失败”）

6. get_veo3_1080p_video

获得1080P高清版本的Veo3视频。

参数：

• task_id （字符串，必填）：获取1080p视频的Veo3任务ID
• index （整数，可选）：视频索引（用于多个视频结果）

备注：不适用于使用回退模式生成的视频。

API终点

服务器与这些Kie.ai API端点接口：

• 视频生成: POST /api/v1/veo/generate ✅ 已验证
• VEO3视频状态: GET /api/v1/veo/record-info ✅ 已验证
• VEO3 1080P升级: GET /api/v1/veo/get-1080p-video ✅ 已验证
• 纳米香蕉一代: POST /api/v1/playground/createTask ✅ 已验证
• 纳米香蕉状态: GET /api/v1/playground/recordInfo ✅ 已验证

所有端点都已通过API实时响应进行了测试和验证。

数据库模式

服务器使用SQLite跟踪任务：

CREATE TABLE tasks (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  task_id TEXT UNIQUE NOT NULL,
  api_type TEXT NOT NULL,  -- 'nano-banana', 'nano-banana-edit', 'veo3'
  status TEXT DEFAULT 'pending',
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  result_url TEXT,
  error_message TEXT
);

使用示例

基本图像生成

# Generate an image
curl -X POST http://localhost:3000/tools/call \
  -H "Content-Type: application/json" \
  -d '{
    "name": "generate_nano_banana",
    "arguments": {
      "prompt": "A cat wearing a space helmet"
    }
  }'

带选项的视频生成

# Generate a video
curl -X POST http://localhost:3000/tools/call \
  -H "Content-Type: application/json" \
  -d '{
    "name": "generate_veo3_video",
    "arguments": {
      "prompt": "A peaceful garden with blooming flowers",
      "aspectRatio": "16:9",
      "model": "veo3_fast"
    }
  }'

错误处理

服务器处理来自Kie.ai的这些HTTP错误代码：

• 200：成功
• 400：违反内容策略/仅提供英文提示
• 401：未经授权（API密钥无效）
• 402：学分不足
• 404：未找到资源
• 422：验证错误/记录为空
• 429：价格有限
• 451：图像访问限制
• 455：服务维护
• 500：服务器错误/超时
• 501：生成失败

发展

# Run tests
npm test

# Development mode with auto-reload
npm run dev

# Type checking
npx tsc --noEmit

# Build for production
npm run build

定价

根据Kie.ai文件：

• 纳米香蕉：每张图片0.020美元（4学分）
• VEO3质量：更高的成本等级
• VEO3快速：质量模型定价的约20%

看https://kie.ai/billing详细定价。

生产技巧

1. 数据库位置：设置 KIE_AI_DB_PATH 到一个持久的位置
2. API密钥安全：从不将API密钥提交到版本控制
3. 速率限制：为高容量使用实施客户端速率限制
4. 监控：监控任务状态并适当处理失败的生成
5. 存储：考虑自动清理旧任务记录

故障排除

常见问题

“未经授权”的错误

• 验证 KIE_AI_API_KEY 设置正确
• 检查API密钥是否在有效https://kie.ai/api-key

“未找到任务”错误

• 任务可能在14天后过期
• 检查任务ID格式是否与预期模式匹配

发电故障

• 检查内容策略合规性
• 验证提示是否为英文
• 确保有足够的API信用

支持

关于以下问题：

• MCP服务器：打开一个问题https://github.com/andrewlwn77/kie-ai-mcp-server/issues
• API基辅：联系方式support@kie.ai或检查https://docs.kie.ai/
• API密钥：参观https://kie.ai/api-key

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

更新日志

v1.0.0

• 初始版本
• Nano Banana图像生成和编辑
• 视频生成
• 1080p视频升级支持
• SQLite任务跟踪
• 智能端点路由
• 全面的错误处理