AI图像生成服务

Leonardo AI MCP Server是一个远程模型上下文协议服务器,提供图像生成、模型管理、生成状态检查、图像升频和变体创建等功能,适用于多种MCP兼容客户端。

  • by superdwayne
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 superdwayne/leonardo-ai-mcp-server

使用说明

🎨 Leonardo AI MCP服务器

遥控器 模型上下文协议(MCP) 服务器 莱昂纳多.ai,由 维塞尔.

生成图像、管理模型、检查生成状态、升级、创建变体——所有这些都可以通过MCP从Cursor、Claude Desktop、VS Code或任何兼容MCP的客户端完成。

✨ 功能/工具

工具 说明
generate_image 使用Leonardo AI生成图像。支持模型选择、尺寸、样式预设、炼金术、PhotoReal和超模式。自动完成投票。
get_generation 按ID获取生成作业的状态和结果
list_models 列出所有可用的Leonardo AI平台模型,包括ID、名称和描述
get_user_generations 为用户获取最新一代作业
get_user_info 获取经过身份验证的用户的信息(用户名、令牌、配额)
create_variation 创建现有图像的变体、外绘、内绘或解压缩
upscale_image 将生成的图像放大到更高的分辨率
delete_generation 永久删除一代及其图像

🚀 部署到Vercel

一键部署

手动部署

  1. 分叉/克隆 这个仓库
  2. 导入 它在 维塞尔
  3. 设置环境变量 LEONARDO_API_KEY 使用Leonardo AI API密钥
  4. 启用流体计算 在Vercel项目设置中实现最佳性能
  5. 部署 --您的MCP服务器将在 https://your-project.vercel.app/mcp

🔑 获取Leonardo AI API密钥

  1. 首选 莱昂纳多.ai
  2. 注册/登录
  3. 在您的设置中导航到API访问
  4. 生成API密钥

🔌 连接您的MCP客户端

光标

添加到光标MCP设置(.cursor/mcp.json):

{
  "mcpServers": {
    "leonardo-ai": {
      "url": "https://your-project.vercel.app/mcp",
      "headers": {
        "x-leonardo-api-key": "YOUR_LEONARDO_API_KEY"
      }
    }
  }
}

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "leonardo-ai": {
      "url": "https://your-project.vercel.app/mcp",
      "headers": {
        "x-leonardo-api-key": "YOUR_LEONARDO_API_KEY"
      }
    }
  }
}

VS代码(GitHub副本)

添加到您的VS Code MCP设置中:

{
  "mcp": {
    "servers": {
      "leonardo-ai": {
        "url": "https://your-project.vercel.app/mcp",
        "headers": {
          "x-leonardo-api-key": "YOUR_LEONARDO_API_KEY"
        }
      }
    }
  }
}

注: 您还可以设置 LEONARDO_API_KEY 作为Vercel上的环境变量,而不是将其作为标头传递。如果设置了env-var,则标头是可选的。

🛠 本地开发

# Install dependencies
pnpm install

# Set your API key
cp .env.example .env
# Edit .env and add your LEONARDO_API_KEY

# Start local dev server
pnpm dev

MCP服务器将在 http://localhost:3000/mcp.

📁 项目结构

├── api/
│   ├── server.ts           # MCP server with all tool definitions
│   └── leonardo-client.ts  # Leonardo AI REST API client
├── public/
│   └── index.html          # Landing page
├── package.json
├── tsconfig.json
├── vercel.json             # Vercel deployment config
├── .env.example
└── README.md

📋 API密钥选项

服务器按照以下顺序解析Leonardo API密钥:

  1. x-leonardo-api-key 头球 --由MCP客户端传递(建议用于多用户设置)
  2. LEONARDO_API_KEY env变量 --在Vercel项目设置中设置(对单个用户更简单)

🧪 示例用法

连接后,您可以在MCP客户端中使用自然语言:

  • “以电影风格生成山上日落的图像”
  • “列出可用的Leonardo AI模型”
  • “让我看看我最近几代人”
  • “升级上次生成的图像”
  • “创建图像xyz的变体”

📝 许可证

麻省理工学院