JinDaGe - freepik-flux-ai-mcp-sunucusu MCP Details

article

README

🚀 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 获取。

安装步骤

克隆或下载此仓库：

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

安装依赖项：
```
npm install
```
复制 .env.example 文件并重命名为 .env，然后添加 Freepik API 密钥：
```
cp .env.example .env
```
编辑 .env 文件，将 FREEPIK_API_KEY 变量替换为您的 API 密钥。

💻 使用示例

基础用法

启动服务器

npm start

在 Claude Desktop 中启动服务

@freepik help

集成到 Claude Desktop

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

进入 Claude Desktop 的设置。

在 mcpServers 部分添加以下配置：

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

重新启动 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 许可证下发布。

freepik-flux-ai-mcp-sunucusu