使用说明

项目简介

本项目 'mcp-server-ghibli-video' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供 AI 图像和视频生成能力。它通过简单的工具接口，允许 LLM 应用轻松地将静态图片转换为动画视频，并提供账户积分查询和任务管理功能。

注意： 本服务依赖于 GPT4O Image Generator 提供的 API 服务。使用前请务必访问该网站获取 API 密钥。

主要功能点

图片转视频 (image_to_video)： 将静态图片转换为宫崎骏动画风格的视频。可以自定义提示词、视频宽高比和负面提示词，生成符合需求的动画视频。
查询积分 (get_points)： 查询您的 GPT4O Image Generator 账户剩余的 API 调用积分，方便您管理使用额度。
任务状态查询 (get_task_result)： 查询图片转视频任务的执行状态，获取视频生成结果。

安装步骤

安装依赖： 在项目根目录下运行以下命令安装项目依赖。
```
npm install
```
构建服务器： 运行以下命令构建服务器代码。
```
npm run build
```

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要配置客户端，添加此服务器的启动信息。以下是配置示例，请根据您的 MCP 客户端配置文件的位置进行修改。

以 Claude Desktop 为例：

打开 Claude Desktop 的配置文件 'claude_desktop_config.json'，通常位于：

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

在 'mcpServers' 字段中添加以下配置信息：

{
  "mcpServers": {
    "mcp-server-ghibli-video": {  // 服务器名称，可以自定义
      "command": "npx",  // 启动命令，这里使用 npx 执行 npm 包
      "args": ["-y", "@openmcprouter/mcp-server-ghibli-video"], // 启动参数，-y 表示自动安装依赖包，@openmcprouter/mcp-server-ghibli-video 是打包后的 npm 包名
      "env": {
        "Ghibli_API_URL": "https://www.gpt4oimg.com" // 环境变量，设置 GPT4O API 的 URL
      }
    }
  }
}

配置说明:

'"mcp-server-ghibli-video"': MCP 服务器的名称，在客户端中用于标识和调用。您可以自定义此名称。
'"command": "npx"': 指定用于启动服务器的命令。 'npx' 允许您执行 npm 包，而无需全局安装。
'"args": ["-y", "@openmcprouter/mcp-server-ghibli-video"]': 'args' 数组包含传递给 'command' 的参数。
- '"-y"': 'npx' 的参数，表示如果找不到指定的 npm 包，则自动安装。
- '"@openmcprouter/mcp-server-ghibli-video"': 指定要执行的 npm 包名称。请注意，实际部署时可能需要根据打包方式调整此参数。
'"env": { "Ghibli_API_URL": "https://www.gpt4oimg.com" }': 'env' 对象允许您设置环境变量。
- '"Ghibli_API_URL": "https://www.gpt4oimg.com"': 设置 'Ghibli_API_URL' 环境变量，指定 GPT4O API 的基础 URL。

重要提示: 请确保您的 MCP 客户端能够正确解析和加载 'claude_desktop_config.json' 文件，并根据配置信息启动 MCP 服务器。实际部署时，您可能需要将服务器打包并发布到 npm，然后客户端可以通过 'npx' 直接执行。

基本使用方法

启动 MCP 服务器： 当 MCP 客户端（如 Claude Desktop）启动时，会根据配置文件中的信息自动启动 'mcp-server-ghibli-video' 服务器。
在 MCP 客户端中调用工具： 在支持 MCP 协议的 LLM 客户端中，您可以使用以下工具来调用服务器的功能：
- image_to_video: 调用图片转视频工具。您需要提供 'image' (Base64 编码的图片数据或图片 URL) 和 'api_key' (GPT4O API 密钥) 作为参数。可选参数包括 'prompt' (提示词), 'aspect_ratio' (视频宽高比), 'negative_prompt' (负面提示词)。
- get_points: 调用查询积分工具。您需要提供 'api_key' (GPT4O API 密钥) 作为参数。
- get_task_result: 调用任务状态查询工具。您需要提供 'taskId' (图片转视频任务 ID) 和 'api_key' (GPT4O API 密钥) 作为参数。
例如，在 Claude 中，您可以指示 Claude 调用 'image_to_video' 工具，并提供必要的参数来生成宫崎骏风格的视频。 具体的调用方式取决于 MCP 客户端的界面和指令格式。

调试

如果需要调试 MCP 服务器，可以使用仓库中提到的 MCP Inspector。运行 'npm run inspector' 命令可以启动 Inspector，并通过浏览器访问调试工具。

关键词