Freepik Flux AI MCP Sunucusu

Freepik Flux AI MCP 服务

本项目是一个供 Claude Desktop 使用的 Model Context Protocol（MCP）服务，可通过 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 密钥。

使用方法

1. 启动服务：

npm start

2. 在 Claude Desktop 应用中使用以下命令运行此服务：

@freepik help

Claude Desktop 集成

按照以下步骤在 Claude Desktop 中配置 MCP 服务：

1. 打开 Claude Desktop 设置。
2. 在 mcpServers 部分添加以下配置：

"mcpServers": {
  "freepik": {
    "command": "node",
    "args": ["indirdiğiniz/konum/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 Bana bir kedi görseli oluştur
   

2. 以指定宽高比生成图像：

   @freepik Bana widescreen_16_9 oranında dağ manzarası oluştur
   

故障排除

• 如果遇到 API 密钥问题，请检查 .env 文件，并确认 Freepik API 密钥正确无误。
• 如果遇到网络连接问题，请检查互联网连接。
• 如果遇到服务运行问题，请确认 Node.js 版本为 20.x 或更高版本。
• 如需查看更多调试信息，请检查控制台输出。

许可证

本项目采用 MIT 许可证。