Ludo MCP

🚀 Ludo AI MCP Server

Model Context Protocol (MCP) を通じて、AIを利用してゲームアセットを生成します。

✨ 主な機能

🚀 クイックスタート

1. APIキーの取得

ludo.ai でサインアップし、app.ludo.ai からAPIキーを取得します。

2. MCPクライアントの設定

Claude Desktop

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)

スプライト、アイコン、背景、UIアセット、テクスチャを生成します。

クレジット: 画像1枚につき0.5

画像編集 (editImage)

テキスト指示を使って既存の画像を変更します (スマート編集)。

クレジット: 画像1枚につき0.5

スタイル付き生成 (generateWithStyle)

参照画像のビジュアルスタイルを維持しながら新しいコンテンツを生成します。

クレジット: 画像1枚につき0.5

ポーズ生成 (generatePose)

既存のスプライトの新しいポーズを生成します。animateSprite の前にこれを使用することで、最適なアニメーション結果を得ることができます - 開始ポーズは意図したアニメーションに合わせる必要があります。

返り値: url, pose, motion_prompt

例のワークフロー:

1. generatePose で "Walk / Run (Left)" ポーズを生成する
2. 返された motion_prompt を animateSprite で直接使用して、最適なアニメーション結果を得る

クレジット: 画像1枚につき0.5

背景削除 (removeImageBackground)

画像から背景を削除し、透過PNGを返します。

返り値: url (透過PNG)

クレジット: 画像1枚につき0.5

3Dモデル生成 (create3DModel)

2D画像をテクスチャ付きの3D GLBモデルに変換します。

返り値: model_url (GLBファイル) + 異なる角度からの4枚のスナップショット画像

クレジット: モデル1つにつき3 処理時間: 60 - 120秒

スプライトアニメーション (animateSprite)

静的画像からアニメーションスプライトシートを作成します。

返り値: spritesheet_url, video_url, gif_url, individual_frame_urls, spritesheet_with_background_url, individual_frame_with_background_urls, num_frames, num_cols, num_rows

クレジット: アニメーション1つにつき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)

ビデオまたはアニメーションプリセットから静的なスプライトにモーションを転送し、アニメーションスプライトシートを生成します。

返り値: spritesheet_url, video_url, gif_url, individual_frame_urls, spritesheet_with_background_url, individual_frame_with_background_urls, num_frames, num_cols, num_rows

クレジット: 転送1回につき5

ビデオ生成 (createVideo)

画像から短いビデオを生成します。

クレジット: 3秒 = 5、5秒 = 8、8秒 = 12、10秒 = 15

効果音生成 (createSoundEffect)

テキスト説明からゲームの効果音を生成します。

クレジット: 音1つにつき3

音楽生成 (createMusic)

BGMやテーマを生成します。

クレジット: トラック1つにつき3

声生成 (createVoice)

独自のキャラクターの声を生成します。

クレジット: 声1つにつき3

テキスト読み上げ (createSpeech)

音声サンプルから声をクローンします。

クレジット: 生成1回につき3

テキスト読み上げプリセット (createSpeechPreset)

テキスト読み上げにプリセットの声を使用します。

クレジット: 生成1回につき3

画像結果の取得 (getImageResults)

最近APIで生成した画像を取得します。

返り値: url, request_id, created_at を持つ画像オブジェクトの配列

クレジット: 無料

スプライト結果の取得 (getSpriteResults)

最近APIで生成したスプライトシートを取得します。

返り値: request_id, created_at を持つスプライトシートオブジェクトの配列

クレジット: 無料

ビデオ結果の取得 (getVideoResults)

最近APIで生成したビデオを取得します。

返り値: url, request_id, created_at を持つビデオオブジェクトの配列

クレジット: 無料

オーディオ結果の取得 (getAudioResults)

最近APIで生成したオーディオを取得します。

返り値: request_id, created_at を持つオーディオオブジェクトの配列

クレジット: 無料

3Dモデル結果の取得 (get3DModelResults)

最近APIで生成した3Dモデルを取得します。

返り値: 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.ludo.ai/api-documentation

サポート

• ドキュメント
• Ludo AIウェブサイト
• GitHubの問題

📄 ライセンス

独自のライセンス - 利用規約については ludo.ai/terms を参照してください。