鲁多AI MCP服务器
通过AI生成游戏资产 模型上下文协议(MCP).
特性
| 类别 | 功能 |
|---|---|
| 图像 | 精灵、图标、截图、背景、UI资源、纹理、背景移除 |
| 3D模型 | 将2D图像转换为具有PBR纹理的GLB模型 |
| 动画 | 静态精灵的动画精灵表(4-64帧),视频或预设的运动传输 |
| 视频 | 从图像生成短视频(3-10秒) |
| 音频 | 音效、背景音乐、角色配音、TTS |
快速开始
1.获取API密钥
注册地址: 卢多艾 并从获取您的API密钥 app.ludo.ai.
2.配置您的MCP客户端
克劳德桌面版
添加 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"ludo": {
"url": "https://mcp.ludo.ai/mcp",
"headers": {
"Authorization": "ApiKey YOUR_API_KEY"
}
}
}
}光标
在光标首选项中添加到MCP设置:
{
"mcpServers": {
"ludo": {
"url": "https://mcp.ludo.ai/mcp",
"headers": {
"Authorization": "ApiKey YOUR_API_KEY"
}
}
}
}可用工具
图像生成(createImage)
生成精灵、图标、背景、UI资源和纹理。
| 参数 | 必填 | 说明 |
|---|---|---|
prompt | 是 | 图像的详细描述 |
image_type | 是的 | sprite, icon, screenshot, art, asset, sprite-vfx, ui_asset, fixed_background, texture, 3d, generic |
art_style | 没有 | Pixel Art (16-Bit), Pixel Art (8-Bit), Low Poly, Cartoonish, Stylized 3D, Flat Design, Anime/Manga, Voxel Art等等。 |
perspective | 没有 | Side-Scroll, Top-Down, Isometric, First-Person, Third-Person, 2.5D |
aspect_ratio | 没有 | default, ar_1_1, ar_4_3, ar_16_9, ar_9_16 |
n | 否 | 变量数量(1-8,默认值:1) |
request_id | 否 | 客户端提供ID以稍后检索结果 |
信用: 每张图片0.5
______________________________________________________________________
编辑图像(editImage)
使用文本指令修改现有图像(智能编辑)。
| 参数 | 必填 | 说明 |
|---|---|---|
image | 是 | 要编辑的URL或base64编码图像 |
prompt | 是 | 更改描述(例如,“删除背景”、“使其更暗”、“为天空添加云”) |
reference_image | 没有 | URL或base64参考图像用于样式/内容指导 |
n | 否 | 变量数量(1-4,默认值:1) |
request_id | 否 | 客户端提供ID以稍后检索结果 |
信用: 每张图片0.5
______________________________________________________________________
用风格生成(generateWithStyle)
生成新内容,同时保持参考图像的视觉风格。
| 参数 | 必填 | 说明 |
|---|---|---|
style_image | 是 | 用于样式匹配的URL或base64编码参考图像 |
prompt | 是 | 生成内容的描述(例如,“战士角色”、“宝箱”) |
image_type | 是的 | sprite, icon, screenshot, art, asset, sprite-vfx, ui_asset, fixed_background, texture, 3d, generic |
n | 否 | 变量数量(1-4,默认值:1) |
request_id | 否 | 客户端提供ID以稍后检索结果 |
信用: 每张图片0.5
______________________________________________________________________
生成姿势(generatePose)
为现有角色生成新姿势。 使用此之前 animateSprite 为了获得最佳的动画效果,起始姿势应该与预期的动画相匹配。
| 参数 | 必填 | 说明 |
|---|---|---|
image | 是 | URL或base64编码的精灵图像 |
pose | 是 | 目标姿势: Idle (Front), Idle (Back), Walk / Run (Left), Attack Ready, Jumping, Crouching, Flying, Defending / Blocking,或任何自定义描述 |
description | 否 | 指导姿势生成的其他说明 |
n | 否 | 变量数量(1-4,默认值:1) |
request_id | 否 | 客户端提供ID以稍后检索结果 |
退货: url, pose, motion_prompt
工作流程示例:
- 生成“步行/跑步(左)”姿势
generatePose - 使用返回的
motion_prompt直接在animateSprite为了获得最佳的动画效果
信用: 每张图片0.5
______________________________________________________________________
删除背景(removeImageBackground)
从图像中删除背景,返回透明的PNG。
| 参数 | 必填 | 说明 |
|---|---|---|
image | 是 | URL或base64编码图像 |
request_id | 否 | 客户端提供ID以稍后检索结果 |
退货: url (透明PNG)
信用: 每张图片0.5
______________________________________________________________________
3D模型生成(create3DModel)
将2D图像转换为具有纹理的3D GLB模型。
| 参数 | 必填 | 说明 |
|---|---|---|
image | 是 | URL或base64编码图像 |
texture_type | 没有 | pbr (默认), simple, none |
texture_size | 没有 | 1024, 2048 (默认) |
target_num_faces | 否 | 三角形计数1000-2000000(默认值:50000) |
request_id | 否 | 客户端提供ID以稍后检索结果 |
退货: model_url (GLB文件)+4张不同角度的快照图像
信用: 每种型号3个 处理时间: 60-120秒
______________________________________________________________________
精灵动画(animateSprite)
从静态图像创建动画精灵表。
| 参数 | 必填 | 说明 |
|---|---|---|
initial_image | 是 | 起始帧的URL或base64 |
motion_prompt | 是 | 动画描述(例如,“行走周期”、“怠速呼吸”、“攻击斜线”) |
image_type | 没有 | sprite, sprite-vfx, ui_asset |
frames | 没有 | 4, 9, 16, 25, 36 (默认), 49, 64 |
frame_size | 没有 | 64, 128, 256 (默认), 0 (最大分辨率) |
loop | 否 | 无缝循环(默认值:true) |
model | 没有 | standard (默认)或 new (质量更高) |
duration | 否 | 标准:1.2-3s,新:4s |
final_image | 否 | 插值结束帧 |
gif | 否 | 生成动画GIF(默认值:false) |
individual_frames | 否 | 提取单个帧图像(默认值:false) |
spritesheet_with_background | 否 | 在删除背景之前,也返回背景完整的spritesheet(默认值:false) |
request_id | 否 | 客户端提供ID以稍后检索结果 |
退货: spritesheet_url, video_url, gif_url, individual_frame_urls, spritesheet_with_background_url, individual_frame_with_background_urls, num_frames, num_cols, num_rows
信用: 每个动画5个 处理时间: 30-90秒
______________________________________________________________________
动画预设(listAnimationPresets)
列出可用于运动传输的可用动画预设。返回预设的动画、透视图和方向,不显示视频URL。
退货:
animations--预设数组id,name,category,description,duration,preview_urlperspectives--阵列与id,name,description(所有动画支持所有视角)directions—["N", "NE", "E", "SE", "S", "SW", "W", "NW"](所有动画支持所有方向)
信用: 自由
______________________________________________________________________
运动转移(transferMotion)
将视频或动画预设中的运动转移到静态精灵上,生成动画精灵表。
| 参数 | 必填 | 说明 |
|---|---|---|
image | 是 | URL或base64编码的精灵图像 |
video | 没有用作运动源的视频的URL。您可以使用animatePrite端点中的视频,也可以提供自己的视频。长达4秒的视频将产生更好的效果。要么 video 或 preset_id + perspective + direction 必须提供。 | |
preset_id | 没有要使用的动画预设的 | ID,而不是视频URL。请使用动画预设端点列出可用的预设。当使用预设时, perspective 和 direction 是必需的。 |
direction | 无 | 动画预设的方向。当使用预设时, direction 是必需的。价值观: N, NE, E, SE, S, SW, W, NW |
perspective | 没有 | 要与动画预设一起使用的透视ID。当使用预设时, perspective 是必需的。 |
frames | 否 | 输出精灵表中的帧数 |
frame_size | 否 | 每帧的大小(像素) |
loop | 否 | 修剪动画以实现无缝循环 |
crop | 否 | 裁剪框架以适应内容 |
margin_ratio | 否 | 在精灵周围填充(0.0-1.0) |
margin_ratio_mode | 没有 | manual (默认), none |
gif | 否 | 生成动画GIF(默认值:false) |
individual_frames | 否 | 提取单个帧图像(默认值:false) |
spritesheet_with_background | 否 | 在删除背景之前,也返回背景完整的spritesheet(默认值:false) |
request_id | 否 | 客户端提供ID以稍后检索结果 |
退货: spritesheet_url, video_url, gif_url, individual_frame_urls, spritesheet_with_background_url, individual_frame_with_background_urls, num_frames, num_cols, num_rows
信用: 每次转账5
______________________________________________________________________
视频生成(createVideo)
从图像生成短视频。
| 参数 | 必填 | 说明 |
|---|---|---|
image | 是 | URL或base64起始帧 |
prompt | 是 | 动作描述(例如,“相机放大”、“角色向前走”) |
duration | 没有 | 3, 5 (默认), 8, 10 秒数 |
model | 没有 | standard (默认)或 new |
final_image | 否 | 插值结束帧 |
request_id | 否 | 客户端提供ID以稍后检索结果 |
信用: 3s=5,5s=8,8s=12,10s=15
______________________________________________________________________
音效生成(createSoundEffect)
根据文本描述生成游戏音效。
| 参数 | 必填 | 说明 |
|---|---|---|
description | 是 | 声音描述(例如,“激光枪射击”、“砾石上的脚步声”、“拾硬币”) |
duration | 否 | 0-10秒(0=自动) |
request_id | 否 | 客户端提供ID以稍后检索结果 |
信用: 每种声音3个
______________________________________________________________________
音乐一代(createMusic)
生成背景音乐和主题。
| 参数 | 必填 | 说明 |
|---|---|---|
description | 是 | 音乐描述(例如,“史诗般的管弦乐战斗主题曲”、“平静的钢琴旋律”、“8位芯片曲调”) |
lyrics | 否 | 声乐曲目的可选歌词 |
request_id | 否 | 客户端提供ID以稍后检索结果 |
信用: 每条轨道3个
______________________________________________________________________
语音生成(createVoice)
生成独特的角色声音。
| 参数 | 必填 | 说明 |
|---|---|---|
voice_description | 是 | 角色描述(例如,“粗鲁的老战士”、“开朗的年轻女孩”) |
text | 是 | 说话文本(最多200个字符) |
type | 没有 | human (默认)或 non-human |
request_id | 否 | 客户端提供ID以稍后检索结果 |
信用: 每个声音3个
______________________________________________________________________
文本转语音(createSpeech)
从音频样本中克隆语音。
| 参数 | 必填 | 说明 |
|---|---|---|
text | 是 | 说话文本(最多1000个字符) |
sample | 是 | 用于语音克隆的URL或base64音频样本 |
request_id | 否 | 客户端提供ID以稍后检索结果 |
信用: 每代3个
______________________________________________________________________
文本转语音预设(createSpeechPreset)
使用预设语音进行文本到语音转换。
| 参数 | 必填 | 说明 |
|---|---|---|
text | 是 | 说话文本(最多1000个字符) |
voice_preset_id | 是的 | Serious woman, Wise woman, Calm woman, Patient man, Determined man, Deep voice man, Teen boy, Sweet girl等等。 |
emotion | 没有 | Default, Happy, Sad, Angry, Fearful, Surprised, Neutral |
language | 没有 | auto, English, Spanish, French, German, Japanese, Korean等等。 |
request_id | 否 | 客户端提供ID以稍后检索结果 |
信用: 每代3个
______________________________________________________________________
检索图像结果(getImageResults)
检索您最近生成的API映像。
| 参数 | 必填 | 说明 |
|---|---|---|
request_id | 否 | 筛选特定请求 |
退货: 图像对象数组 url, request_id, created_at
信用: 自由
______________________________________________________________________
检索Sprite结果(getSpriteResults)
检索您最近的API生成的子画面。
| 参数 | 必填 | 说明 |
|---|---|---|
request_id | 否 | 筛选特定请求 |
退货: spritesheet对象数组 request_id, created_at
信用: 自由
______________________________________________________________________
检索视频结果(getVideoResults)
检索您最近的API生成的视频。
| 参数 | 必填 | 说明 |
|---|---|---|
request_id | 否 | 筛选特定请求 |
退货: 视频对象数组 url, request_id, created_at
信用: 自由
______________________________________________________________________
检索音频结果(getAudioResults)
检索您最近的API生成的音频。
| 参数 | 必填 | 说明 |
|---|---|---|
request_id | 否 | 筛选特定请求 |
退货: 音频对象数组 request_id, created_at
信用: 自由
______________________________________________________________________
检索三维模型结果(get3DModelResults)
检索最近的API生成的三维模型。
| 参数 | 必填 | 说明 |
|---|---|---|
request_id | 否 | 筛选特定请求 |
退货: 3D资源对象数组 request_id, created_at
信用: 自由
______________________________________________________________________
异步用法
你可以使用 request_id 建立即发即弃工作流程。用标签标记任何生成请求 request_id,然后轮询相应的结果端点,以便在输出准备就绪时获取输出——无需保持连接打开。
- 通过a
request_id在您的世代请求中 - 轮询相应的结果端点以检索输出
# Fire off a sprite animation
animateSprite with request_id="my-anim-001", initial_image="url", motion_prompt="walking"
# Retrieve the result whenever you're ready
getSpriteResults with request_id="my-anim-001"所有生成端点都接受可选 request_id 参数。结果可供使用7天,每个结果端点最多返回100个最新的API生成的资产。
______________________________________________________________________
资产URL过期
所有生成的资产URL(图像、精灵表、视频、音频、3D模型)都是临时的,在 7天。如果您需要保留资产,请在到期前下载。
______________________________________________________________________
示例提示
创建游戏资产
Create a pixel art knight character with sword and shield, side view, 16-bit styleGenerate an isometric treasure chest icon for a mobile RPGCreate a low-poly stylized tree for a casual mobile game动画
Animate this character with a smooth walking cycle, 16 framesCreate an idle breathing animation for this character spriteAnimate this fire sprite as a looping VFX effect音频
Create a satisfying coin pickup sound effect for a platformerGenerate an epic orchestral boss battle theme, intense and dramaticCreate a voice for a wise old wizard saying "The journey begins now"API 文档
API完整文档,包括所有参数和响应格式: api.ludo.ai/api-documentation
支持
许可证
专有-见 ludo.ai/条款 关于服务条款。
