Freepik Flux AI MCP 服务器

本项目是一个模型上下文协议 (MCP) 服务器，它使用 Freepik 的 Flux AI 图像生成服务，通过文本描述为 Claude Desktop 生成图像。

特性

• 通过文本描述生成图像
• 多种宽高比选项
• 在浏览器中自动打开图像
• 强大的错误管理和重试机制

需求

• 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)

配置

您可以在 .env 文件中配置以下设置：

• FREEPIK_API_KEY: 您的 Freepik API 密钥（必需）
• REQUEST_TIMEOUT: 请求超时时间（毫秒，默认值：30000）
• RETRY_ATTEMPTS: 失败请求的重试次数（默认值：3）

示例

1. 生成一个简单的图像：

   @freepik 帮我生成一张猫的图片
   

2. 生成具有特定宽高比的图像：

   @freepik 帮我生成一张 widescreen_16_9 比例的山景
   

故障排除

• 对于 API 密钥问题，请检查 .env 文件并确保您的 Freepik API 密钥正确。
• 对于网络连接问题，请检查您的互联网连接。
• 对于服务器运行问题，请确保您的 Node.js 版本为 20.x 或更高版本。
• 有关更多调试信息，请检查控制台输出。

许可证

本项目在 MIT 许可证下获得许可。