Mcp Happyhorse

io.github.AceDataCloudv2026.10.4.1更新於 Oct 4, 2026

Generate and edit Happy Horse AI videos through Ace Data Cloud

已驗證Streamable HTTP可網頁執行AI & ML Media & Design

概覽

AI 產生的概覽

讓助理透過 Ace Data Cloud 以文字、圖片或參考圖生成與編輯 Happy Horse AI 影片。

功能: 包裝 Happy Horse 影片 API，提供文字生成影片、首帧圖片動畫、使用 1-9 張參考圖生成影片，以及最多 5 張參考圖的影片編輯工具。另外提供單一與批次任務查詢工具，以及模型列表工具。生成採非同步方式：助理需保留回傳的 task_id 並持續輪詢，直到出現最終 video_url 或錯誤。輸出為 720P 或 1080P，長度 3-15 秒。
適用情境: 適合在對話中讓助理產生短影片或編輯現有片段，例如把提示詞或靜態圖片變成影片，或對來源影片做風格化處理。也適合已在使用 Ace Data Cloud、想省去自行串接 API 的使用者。
執行需求: 可使用 happyhorse.mcp.acedata.cloud 遠端端點，或從 PyPI 安裝本機程序（mcp-happyhorse，以 uvx 或 pip 執行）。本機 stdio 模式需要環境變數 ACEDATACLOUD_API_TOKEN；託管端點接受 Bearer 權杖標頭或 OAuth。權杖需從 Ace Data Cloud 平台取得。需要能連線至 Ace Data Cloud API 的網路。

安裝前請注意

需要 ACEDATACLOUD_API_TOKEN 密鑰，用於授權 API 呼叫，可能在 Ace Data Cloud 帳戶產生費用。生成與編輯會把任務提交至第三方服務，提示詞、圖片與影片都會傳送給 Ace Data Cloud。影片生成為非同步並消耗額度或配額，大量使用前請先確認計費方式。

安裝

在 SourceWeft 中

開啟儀表板中的 Mcp Happyhorse，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "mcp-happyhorse": {
      "type": "http",
      "url": "https://happyhorse.mcp.acedata.cloud/mcp"
    }
  }
}

README

Happy Horse MCP Server

[PyPI] [Python] [License]

Model Context Protocol server for Happy Horse AI video generation and editing through the Ace Data Cloud API.

Capabilities

Text-to-video generation
First-frame image-to-video animation
Reference-to-video generation with 1-9 subject or style images
Video editing with up to 5 reference images
720P and 1080P output
Single and batch task polling
Local stdio and hosted Streamable HTTP/SSE transports
Direct Bearer token and AceDataCloud OAuth authentication

Install

Get a token from platform.acedata.cloud.

Configure

Claude Desktop

json

{  "mcpServers": {    "happyhorse": {      "command": "uvx",      "args": ["mcp-happyhorse"],      "env": {        "ACEDATACLOUD_API_TOKEN": "your-token"      }    }  }}

{  "mcpServers": {    "happyhorse": {      "command": "uvx",      "args": ["mcp-happyhorse"],      "env": {        "ACEDATACLOUD_API_TOKEN": "your-token"      }    }  }}

Hosted MCP

json

{  "mcpServers": {    "happyhorse": {      "url": "https://happyhorse.mcp.acedata.cloud/mcp",      "headers": {        "Authorization": "Bearer your-token"      }    }  }}

{  "mcpServers": {    "happyhorse": {      "url": "https://happyhorse.mcp.acedata.cloud/mcp",      "headers": {        "Authorization": "Bearer your-token"      }    }  }}

The hosted endpoint also supports OAuth-capable MCP clients.

Tools

Tool	Purpose
`happyhorse_generate_video`	Generate a video from text
`happyhorse_generate_video_from_image`	Animate one first-frame image
`happyhorse_generate_video_from_references`	Generate from 1-9 reference images
`happyhorse_edit_video`	Edit a source video with up to 5 references
`happyhorse_get_task`	Query one task
`happyhorse_get_tasks_batch`	Query multiple tasks
`happyhorse_list_models`	List valid models for each action

Generation tools submit asynchronously when no callback_url is supplied. Keep the returned task_id, wait about 15 seconds, then call happyhorse_get_task until the response contains a final video_url or terminal error.

Models

Action	Models	Default
Text-to-video	`happyhorse-1.0-t2v`, `happyhorse-1.1-t2v`	`happyhorse-1.1-t2v`
Image-to-video	`happyhorse-1.0-i2v`, `happyhorse-1.1-i2v`	`happyhorse-1.1-i2v`
Reference-to-video	`happyhorse-1.0-r2v`, `happyhorse-1.1-r2v`	`happyhorse-1.1-r2v`
Video edit	`happyhorse-1.0-video-edit`	`happyhorse-1.0-video-edit`

Generation duration is 3-15 seconds. Supported resolutions are 720P and 1080P. Text and reference generation support 16:9, 9:16, 1:1, 4:3, and 3:4. Image-to-video follows the input image ratio. Video-edit duration follows the source video.

Example Requests

Ask your MCP client:

Generate a 720P, 9:16 video of a white horse crossing a snowy ridge at sunrise.

Animate https://example.com/horse.jpg with a slow camera push and wind moving the mane.

Edit https://example.com/source.mp4 to preserve the camera motion but apply the costume style from https://example.com/reference.jpg. Keep the original audio.

Environment

Variable	Default	Purpose
`ACEDATACLOUD_API_TOKEN`	none	API token for local stdio mode
`ACEDATACLOUD_API_BASE_URL`	`https://api.acedata.cloud`	API origin
`HAPPYHORSE_REQUEST_TIMEOUT`	`60`	HTTP request timeout in seconds
`MCP_TRANSPORT`	`stdio`	`stdio` or `http`
`MCP_SERVER_URL`	none	Public URL that enables hosted OAuth
`LOG_LEVEL`	`INFO`	Logging level

Development

Documentation

License

MIT

來源：README.md，提交 2be1ac9

工具

工具後設資料尚未被收錄。

版本歷史

v2026.10.4.1最新Oct 4, 2026