使用说明
🎨 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
一键部署
手动部署
- 分叉/克隆 这个仓库
- 导入 它在 维塞尔
- 设置环境变量
LEONARDO_API_KEY使用Leonardo AI API密钥 - 启用流体计算 在Vercel项目设置中实现最佳性能
- 部署 --您的MCP服务器将在
https://your-project.vercel.app/mcp
🔑 获取Leonardo AI API密钥
- 首选 莱昂纳多.ai
- 注册/登录
- 在您的设置中导航到API访问
- 生成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密钥:
x-leonardo-api-key头球 --由MCP客户端传递(建议用于多用户设置)LEONARDO_API_KEYenv变量 --在Vercel项目设置中设置(对单个用户更简单)
🧪 示例用法
连接后,您可以在MCP客户端中使用自然语言:
- “以电影风格生成山上日落的图像”
- “列出可用的Leonardo AI模型”
- “让我看看我最近几代人”
- “升级上次生成的图像”
- “创建图像xyz的变体”
📝 许可证
麻省理工学院