Freepik Flux AI MCP 服务

此项目为 Claude Desktop 提供了一个使用 Freepik 的 Flux AI 图像生成服务，从文本描述中创建图像的模型上下文协议（MCP）服务器。

特性

• 从文本描述生成图像
• 多种宽高比选项
• 自动在浏览器中打开图像
• 健壮的错误处理和重试机制

先决条件

• Node.js 20.x 或更高版本
• Freepik API 密钥（可从 https://www.freepik.com/developers/dashboard/api-key 获取）

安装步骤

1. 克隆或下载此仓库：

   git clone https://github.com/grafikogr/freepik-mcp-server.git
   cd freepik-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 复制 .env.example 文件并重命名为 .env，然后添加 Freepik API 密钥：

   cp .env.example .env
   

4. 编辑 .env 文件并将 FREEPIK_API_KEY 变量替换为您的 API 密钥。

使用方法

1. 启动服务器：

   npm start
   

2. 在 Claude Desktop 中运行以下命令来启动该服务器：

   @freepik help
   

集成到 Claude Desktop

要在 Claude Desktop 中配置此 MCP 服务器，请按照以下步骤操作：

1. 进入 Claude Desktop 的设置。
2. 在 mcpServers 部分添加以下配置：

   "mcpServers": {
     "freepik": {
       "command": "node",
       "args": ["您下载的路径/freepik-mcp-server/index.js"]
     }
   }
   

3. 重新启动 Claude Desktop。

工具

generate_image

根据文本描述和可选的图像比例生成图像。

参数：

• prompt：图像的文本描述（必填）
• aspect_ratio：图像的比例（可选）

可用图像比例：

• square_1_1：正方形 (1:1)
• classic_4_3：经典 (4:3)
• traditional_3_4：传统 (3:4)
• widescreen_16_9：宽屏 (16:9)
• social_story_9_16：社交故事 (9:16)
• standard_3_2：标准 (3:2)
• portrait_2_3：肖像 (2:3)
• horizontal_2_1：水平 (2:1)
• vertical_1_2：垂直 (1:2)
• social_post_4_5：社交帖子 (4:5)

配置

所有内容都在 config.json 文件中进行配置。

错误处理

常见错误

1. API 密钥错误

Error: Freepik API key is invalid

2. 网络问题

Error: Failed to connect to Freepik server

3. 无效的输入描述

Error: Invalid input description format

解决方法

1. API 密钥错误：

   • 检查您的 API 密钥是否正确。
   • 确保您已注册并激活 Freepik 的开发者计划。

2. 网络问题：

   • 检查您的互联网连接。
   • 尝试更换网络环境或联系您的 Internet Service Provider (ISP)。

3. 无效输入描述：

   • 确保输入的文本描述符合格式要求。
   • 避免使用特殊字符和不支持的语言。

日志记录

服务提供详细的日志输出，便于调试：

# 查看实时日志
npm run logs

# 查看历史日志
npm run history

许可证

此项目在 MIT 许可证下发布。