Leonardo AI MCP Server

Leonardo AI MCP 服务

一个 MCP（Model Context Protocol）服务，可通过 Leonardo AI 的图像生成 API 生成图像，每天提供 150 个免费额度。

功能

• 使用各种 AI 模型生成高质量图像
• 每天提供 150 个免费额度（午夜刷新）
• 支持多种艺术风格和模型
• 批量生成（每次 1-4 张图像）
• 将图像保存到本地或获取 URL
• 查看剩余额度

可用模型

• Leonardo Diffusion XL：高质量通用模型
• Leonardo Vision XL：照片写实和艺术风格
• Leonardo Anime XL：动漫和漫画风格图像
• DreamShaper v7：奇幻和梦幻风格图像
• Realistic Vision v5：高度写实的照片

安装

1. 克隆此仓库：

git clone https://github.com/nikolausm/leonardo-ai-mcp-server.git
cd leonardo-ai-mcp-server

2. 安装依赖项：

npm install

3. 获取 Leonardo AI API 密钥：

   • 在 https://leonardo.ai 注册（免费）
   • 前往 API 设置
   • 生成 API 密钥
   • 复制密钥

4. 设置环境变量：

export LEONARDO_API_KEY="your_api_key_here"

在 Claude Desktop 中配置

将以下内容添加到 Claude Desktop 配置文件中（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "leonardo-ai": {
      "command": "node",
      "args": ["/path/to/leonardo-ai-mcp-server/index.js"],
      "env": {
        "LEONARDO_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用方法

生成图像

// Basic usage
generate_image({
  prompt: "a majestic castle on a hilltop at sunset"
})

// Advanced usage
generate_image({
  prompt: "cute cartoon guinea pig with big eyes",
  model: "leonardo-anime-xl",
  negative_prompt: "realistic, scary, dark",
  num_images: 2,
  width: 768,
  height: 768,
  guidance_scale: 10,
  save_path: "/tmp/guinea_pig.png"
})

查看剩余额度

check_credits()

列出可用模型

list_models()

免费额度系统

• 每天 150 个额度（于 UTC 午夜重置）
• 每张图像约需 2 个额度
• 每天可免费生成约 75 张图像！
• 无需信用卡

提高效果的技巧

1. 使用特定模型：

   • leonardo-anime-xl 适用于动漫／卡通风格
   • realistic-vision-v5 适用于照片写实图像
   • dreamshaper-v7 适用于奇幻艺术

2. 优化尺寸：

   • 使用 8 的倍数（512、768、1024）
   • 正方形图像通常效果最好

3. 负面提示词很有效：

   • 使用它们来避免不想要的元素
   • 示例：“模糊、低质量、扭曲”

示例

儿童读物插图

generate_image({
  prompt: "friendly guinea pig reading a book, children's illustration, soft pastel colors",
  model: "leonardo-diffusion-xl",
  negative_prompt: "realistic, dark, scary",
  width: 768,
  height: 768
})

教育海报

generate_image({
  prompt: "educational poster showing guinea pig care, clean design, infographic style",
  model: "leonardo-vision-xl",
  num_images: 3,
  guidance_scale: 12
})

错误处理

此服务可处理常见错误：

• API 密钥无效
• 额度不足
• 生成失败
• 超时问题

许可证

MIT

作者

Michael Nikolaus

链接

• Leonardo AI
• API 文档