Ghibli Video Generator

🚀 mcp-server-ghibli - 2D Image and Video Generation MCP Server

This is a TypeScript-based MCP server that offers AI image and video generation capabilities through simple interfaces.

⚠️ Important Note

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

✨ Features

Tools

1. Image-to-Video Conversion

• image_to_video - Convert static images to animated videos
  • Required parameters:
    • image: Base64-encoded image or image URL
    • api_key: Authentication key
  • Optional parameters:
    • prompt: Text prompt to guide video generation (Default: "In the style of Hayao Miyazaki")
    • 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 - Check the remaining API quota
  • 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

Development

Install dependencies:

npm install

Build the server:

npm run build

Development with auto-rebuild:

npm run watch

Integration with Claude Desktop

To use with Claude Desktop, add the server configuration:

• 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"
      }
    }
  }
}

Debugging

Debugging can be challenging as the MCP server communicates via standard input and output. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The inspector will provide a URL for the debugging tools in your browser.