Ludo MCP

🚀 Ludo AI MCP 服務器

通過模型上下文協議 (MCP) 使用人工智能生成遊戲資源。

✨ 主要特性

類別	功能
圖像	精靈圖、圖標、截圖、背景、UI 資源、紋理、去除背景
3D 模型	將 2D 圖像轉換為帶有 PBR 紋理的 GLB 模型
動畫	從靜態精靈圖生成動畫精靈表單（4 - 64 幀），從視頻或預設進行動作遷移
視頻	從圖像生成短視頻（3 - 10 秒）
音頻	音效、背景音樂、角色語音、文本轉語音

🚀 快速開始

1. 獲取 API 密鑰

在 ludo.ai 上註冊，並從 app.ludo.ai 獲取你的 API 密鑰。

2. 配置 MCP 客戶端

Claude 桌面端

在 macOS 系統中，將以下內容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 文件；在 Windows 系統中，添加到 %APPDATA%\Claude\claude_desktop_config.json 文件：

{
  "mcpServers": {
    "ludo": {
      "url": "https://mcp.ludo.ai/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

Cursor

在 Cursor 偏好設置的 MCP 設置中添加以下內容：

{
  "mcpServers": {
    "ludo": {
      "url": "https://mcp.ludo.ai/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

💻 使用示例

基礎用法

以下是一個使用 createImage 生成圖像的示例：

# 假設使用 Python 調用 API
import requests

url = "https://mcp.ludo.ai/mcp"
headers = {
    "Authorization": "ApiKey YOUR_API_KEY"
}
data = {
    "prompt": "A pixel art knight character with sword and shield, side view, 16-bit style",
    "image_type": "sprite",
    "art_style": "Pixel Art (16-Bit)"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

高級用法

以下是一個使用 animateSprite 生成動畫精靈表單的示例：

import requests

url = "https://mcp.ludo.ai/mcp"
headers = {
    "Authorization": "ApiKey YOUR_API_KEY"
}
data = {
    "initial_image": "url_of_initial_image",
    "motion_prompt": "walking cycle",
    "frames": 16
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

📦 可用工具

圖像生成 (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

示例工作流程：

1. 使用 generatePose 生成 “Walk / Run (Left)” 姿勢
2. 直接將返回的 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（默認值）、4096
target_num_faces	否	三角形數量 1,000 - 100,000（默認值：50,000）
high_detail_shape	否	啟用複雜形狀（較慢）
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 - 3 秒，新：4 秒
final_image	否	用於插值的結束幀
gif	否	生成動畫 GIF（默認值：false）
individual_frames	否	提取單個幀圖像（默認值：false）
spritesheet_with_background	否	還返回去除背景之前帶有完整背景的精靈表單（默認值：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_url 的預設數組
• perspectives — 包含 id、name、description 的數組（所有動畫支持所有視角）
• directions — ["N", "NE", "E", "SE", "S", "SW", "W", "NW"]（所有動畫支持所有方向）

費用：免費

動作遷移 (transferMotion)

將視頻或動畫預設中的動作遷移到靜態精靈圖上，生成動畫精靈表單。

參數	是否必需	描述
image	是	精靈圖的 URL 或 Base64 編碼圖像
video	否	用作動作源的視頻 URL。你可以使用 animateSprite 端點的視頻或提供自己的視頻。長達 4 秒的視頻將產生更好的效果。必須提供 video 或 preset_id + perspective + direction。
preset_id	否	用於代替視頻 URL 的動畫預設 ID。使用 animation-presets 端點列出可用預設。使用預設時，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	否	還返回去除背景之前帶有完整背景的精靈表單（默認值：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，用於稍後檢索結果

費用：3 秒 = 5 積分，5 秒 = 8 積分，8 秒 = 12 積分，10 秒 = 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 的圖像對象數組

費用：免費

檢索精靈圖結果 (getSpriteResults)

檢索你最近通過 API 生成的精靈表單。

參數	是否必需	描述
request_id	否	過濾到特定請求

返回值：包含 request_id、created_at 的精靈表單對象數組

費用：免費

檢索視頻結果 (getVideoResults)

檢索你最近通過 API 生成的視頻。

參數	是否必需	描述
request_id	否	過濾到特定請求

返回值：包含 url、request_id、created_at 的視頻對象數組

費用：免費

檢索音頻結果 (getAudioResults)

檢索你最近通過 API 生成的音頻。

參數	是否必需	描述
request_id	否	過濾到特定請求

返回值：包含 request_id、created_at 的音頻對象數組

費用：免費

檢索 3D 模型結果 (get3DModelResults)

檢索你最近通過 API 生成的 3D 模型。

參數	是否必需	描述
request_id	否	過濾到特定請求

返回值：包含 request_id、created_at 的 3D 資產對象數組

費用：免費

📚 詳細文檔

異步使用

你可以使用 request_id 構建即發即忘的工作流程。在任何生成請求中標記一個 request_id，然後輪詢相應的結果端點，在輸出準備好時獲取結果 — 無需保持連接打開。

1. 在生成請求中傳遞 request_id
2. 輪詢相應的結果端點以檢索輸出

# 發起一個精靈動畫請求
animateSprite with request_id="my-anim-001", initial_image="url", motion_prompt="walking"

# 準備好時檢索結果
getSpriteResults with request_id="my-anim-001"

所有生成端點都接受可選的 request_id 參數。結果可保留 7 天，每個結果端點最多返回 100 個最近通過 API 生成的資產。

示例提示

創建遊戲資源

Create a pixel art knight character with sword and shield, side view, 16-bit style

Generate an isometric treasure chest icon for a mobile RPG

Create a low-poly stylized tree for a casual mobile game

動畫

Animate this character with a smooth walking cycle, 16 frames

Create an idle breathing animation for this character sprite

Animate this fire sprite as a looping VFX effect

音頻

Create a satisfying coin pickup sound effect for a platformer

Generate an epic orchestral boss battle theme, intense and dramatic

Create a voice for a wise old wizard saying "The journey begins now"

📄 API 文檔

包含所有參數和響應格式的完整 API 文檔：api.ludo.ai/api-documentation

📚 支持

• 文檔
• Ludo AI 網站
• GitHub 問題

📄 許可證

專有許可 - 請參閱 ludo.ai/terms 獲取服務條款。