Ghibli MCP Video Server

🚀 MCP Server for Ghibli

An MCP server built with TypeScript, offering AI image and video generation capabilities through a simple interface.

⚠️ Important Note

This server requires an API key from the GPT4O Image Generator. Please visit the website to obtain your API key before using this service.

✨ Features

Tools

1. Image to Video

• image_to_video - Convert a static image into an animated video
  • Required parameters:
    • image: Base64-encoded image or image URL
    • api_key: Authentication key
  • Optional parameters:
    • prompt: Text prompt to guide video generation (Default: "ghibli style")
    • aspect_ratio: Aspect ratio of the output video (Default: "9:16")
    • negative_prompt: Negative prompt to guide generation (Default: "bad prompt")

2. Points Management

• get_points - Query the remaining API credits
  • Required parameters:
    • api_key: Authentication key

3. Task Management

• get_task_result - Check the status of a video generation task
  • Required parameters:
    • taskId: Task ID returned by image_to_video
    • api_key: Authentication key

📦 Installation

Add Server Configuration when Using with Claude Desktop

• On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-ghibli-video": {
      "command": "npx",
      "args": ["-y", "@openmcprouter/mcp-server-ghibli-video"],
      "env": {
        "Ghibli_API_URL": "https://www.gpt4oimg.com"
      }
    }
  }
}

💻 Usage Examples

Development

Install Dependencies

npm install

Build the Server

npm run build

Development with Automatic Rebuild

npm run watch

Debugging

Since the MCP server communicates via stdio, debugging can be challenging. We recommend using MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access the debugging tools in the browser.