Gif Creator MCP

🚀 GIF Creator MCP

GIF Creator MCP 是一個 MCP（模型上下文協議）服務器，可將視頻文件轉換為 GIF 動畫。它能幫助你輕鬆地把各種視頻轉換為高質量的 GIF 格式，滿足多樣化的使用需求。

✨ 主要特性

• 可將任意視頻文件轉換為 GIF 格式。
• 能夠自定義輸出設置，如幀率（FPS）、尺寸和時長。
• 可以提取視頻的特定部分。
• 採用優化調色板生成高質量的 GIF。

📦 安裝指南

npm install
npm run build

💻 使用示例

基礎用法

目前，Claude Desktop 不支持視頻輸入。建議使用其他客戶端，如 Goose 並將其作為擴展添加。 在 Goose 中，你可以通過以下步驟使用 Gif Creator 工具：進入高級設置 > 擴展 > + 添加自定義擴展，然後在命令中粘貼：

node /path/to/gif-creator-mcp/dist/index.js

同時，建議將超時時間增加到 1000。

對於其他 MCP 客戶端，你可以使用以下命令啟動服務器：

{
  "mcpServers": {
    "gif-creator": {
      "command": "node",
      "args": ["/path/to/gif-creator-mcp/dist/index.js"]
    }
  }
}

高級用法

工具 convert_video_to_gif

該工具可將視頻文件轉換為 GIF 文件，並將其保存到源視頻所在的同一目錄。

參數說明：

• video_path（必填）：要轉換的視頻文件路徑。
• fps（可選）：GIF 的幀率（範圍 1 - 30，默認值為 10）。
• width（可選）：輸出 GIF 的寬度（若未指定高度，則保持寬高比）。
• height（可選）：輸出 GIF 的高度（若未指定寬度，則保持寬高比）。
• start_time（可選）：開始時間（以秒為單位，默認值為 0）。
• duration（可選）：時長（以秒為單位，默認值為整個視頻）。

具體示例

基本轉換

{
  "video_path": "/path/to/video.mp4"
}

自定義設置

{
  "video_path": "/path/to/video.mp4",
  "fps": 15,
  "width": 480,
  "start_time": 5,
  "duration": 10
}

提取特定部分

{
  "video_path": "/path/to/long-video.mov",
  "start_time": 30,
  "duration": 5,
  "fps": 20
}

🔧 技術細節

依賴要求

• Node.js
• FFmpeg（通過 @ffmpeg-installer/ffmpeg 自動安裝）

注意事項

⚠️ 重要提示

• 輸出的 GIF 文件將保存在輸入視頻所在的同一目錄。
• 文件名與視頻文件相同，但擴展名為 .gif。
• 處理大視頻可能需要一些時間。
• 該工具使用優化調色板生成以提高 GIF 質量。

📄 許可證

本項目採用 MIT 許可證。