🚀 Freepik Flux AI MCP 服务

本项目为 Claude Desktop 打造了一个模型上下文协议（MCP）服务器，借助 Freepik 的 Flux AI 图像生成服务，能够依据文本描述生成图像。

🚀 快速开始

此项目为 Claude Desktop 提供了使用 Freepik 的 Flux AI 图像生成服务的能力，可从文本描述创建图像。按照以下步骤，即可快速开启图像生成之旅。

✨ 主要特性

• 支持依据文本描述生成图像。
• 提供多种宽高比选项，满足多样化需求。
• 可自动在浏览器中打开生成的图像。
• 具备健壮的错误处理和重试机制，保障服务稳定。

📦 安装指南

环境准备

• 需安装 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 密钥。

💻 使用示例

基础用法

启动服务器

npm start

在 Claude Desktop 中启动服务

在 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 文件中进行配置。

错误处理

常见错误

• API 密钥错误

Error: Freepik API key is invalid

• 网络问题

Error: Failed to connect to Freepik server

• 无效的输入描述

Error: Invalid input description format

解决方法

• API 密钥错误：
  • 检查您的 API 密钥是否正确。
  • 确保您已注册并激活 Freepik 的开发者计划。
• 网络问题：
  • 检查您的互联网连接。
  • 尝试更换网络环境或联系您的 Internet Service Provider (ISP)。
• 无效输入描述：
  • 确保输入的文本描述符合格式要求。
  • 避免使用特殊字符和不支持的语言。

日志记录

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

# 查看实时日志
npm run logs

# 查看历史日志
npm run history

📄 许可证

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