AI导哈

图像生成服务

Kie AI MCP Server是一个桥接Kie AI图像生成API的服务，用于创建任务、轮询完成状态并将生成的图像保存到磁盘。

  • by artschekoff
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 artschekoff/nanobanana-mcp

使用说明

选择AI MCP服务器

MCP服务器，桥接到Kie AI图像生成API。创建任务，轮询完成情况，并将生成的映像保存到磁盘。适用于任何提示和风格。

作者 roxl.net

示例

它做什么

  • 通过Kie AI创建图像生成任务
  • 轮询任务状态直到完成（或为异步流返回任务id）
  • 下载生成的映像并将其写入磁盘
  • 支持并行批量生成，每个项目都有明确的样式/提示

快速开始

# Build
make build

# Copy env template and add your API key
cp .env.example .env
# edit .env — set KIE_AI_API_KEY

# Run
./bin/kie-ai-mcp

环境变量

变量 必填 默认 描述
KIE_AI_API_KEY 是 -- 你的 选择AI API密钥
KIE_AI_BASE_URL 没有 https://api.kie.ai/api/v1 API基本URL
KIE_AI_MODEL 没有 nano-banana-pro 图像生成模型
KIE_AI_OUTPUT_DIR 没有 output 保存生成图像的目录
KIE_AI_TIMEOUT_SECONDS 没有 90 每请求HTTP超时
KIE_AI_POLL_INTERVAL_SECONDS 没有 3 任务状态轮询之间的秒数
KIE_AI_POLL_TIMEOUT_SECONDS 没有 300 等待任务完成的最长秒数
KIE_AI_HTTP_RETRIES 没有 3 对暂时性HTTP错误重试
KIE_AI_HTTP_RETRY_BACKOFF_SECONDS 没有 1.5 重试的初始回退延迟（每次尝试加倍）

复制 .env.example 到 .env 并填写 KIE_AI_API_KEY 至少。

鱼壳（全局，无.env文件）

将变量设置为通用fish变量，以便它们在会话中持久存在，并可用于任何进程：

set -Ux KIE_AI_API_KEY your-api-key-here
set -Ux KIE_AI_BASE_URL https://api.kie.ai/api/v1
set -Ux KIE_AI_MODEL nano-banana-pro
set -Ux KIE_AI_OUTPUT_DIR output
set -Ux KIE_AI_TIMEOUT_SECONDS 90
set -Ux KIE_AI_POLL_INTERVAL_SECONDS 3
set -Ux KIE_AI_POLL_TIMEOUT_SECONDS 300
set -Ux KIE_AI_HTTP_RETRIES 3
set -Ux KIE_AI_HTTP_RETRY_BACKOFF_SECONDS 1.5

-U 使变量通用（跨会话持久）， -x 将其导出到子进程。不 .env 需要文件。

MCP主机配置（建议分发）

通过MCP主机传递密钥 env block——密钥存在于仓库之外，从不出现在工具消息或日志中。

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "kie-ai-mcp": {
      "command": "/path/to/kie-ai-mcp",
      "env": {
        "KIE_AI_API_KEY": "your-key-here"
      }
    }
  }
}

克劳德代码 (.claude/mcp_servers.json 或 ~/.claude/mcp_servers.json):

{
  "kie-ai-mcp": {
    "command": "/path/to/kie-ai-mcp",
    "env": {
      "KIE_AI_API_KEY": "your-key-here"
    }
  }
}

不 .env 需要文件。可选变量(KIE_AI_MODEL, KIE_AI_OUTPUT_DIR等等）可以添加到同一个 env 块。

MCP工具

  • describe_imager_interface --返回工具合同和环境信息。
  • create_visual_task --创建任务并返回 task_id.
  • get_visual_task --按以下方式获取任务状态 task_id.
  • generate_visual --创建任务并等待生成的图像。
  • generate_visual_batch --并行运行多代(items[], default_style, max_workers，每项输出/错误）。

备注

  • 服务器读取 .env 从工作目录或包含二进制文件的目录。
  • 图像保存到 KIE_AI_OUTPUT_DIR 除非 output_path 每次呼叫都会传递。
  • 不要承诺你的 .env.

参考文献

  • API详细信息： references/kie-api.md

相关 MCP