Freepik MCP Server

基本能力

产品定位

Freepik MCP Server 是一个中间件服务，旨在为开发者提供便捷的 Freepik API 访问能力，特别是针对图像资源和 AI 图像生成功能。

核心功能

• 搜索 Freepik 资源：支持照片、矢量图、PSD 文件的搜索，并提供多种过滤选项。
• 获取资源详细信息：根据资源 ID 获取详细资源信息。
• 下载资源：提供资源下载功能。
• AI 图像生成：使用 Freepik Mystic AI 生成图像，支持多种分辨率和风格选项。
• 任务状态检查：检查 AI 图像生成任务的状态。

适用场景

• 内容创作：快速获取高质量的图像资源或生成符合需求的 AI 图像。
• 开发集成：将 Freepik 资源或 AI 图像生成功能集成到其他应用中。
• 设计工具：为设计工具提供图像资源支持。

工具列表

1. search_resources：搜索 Freepik 资源，支持多种过滤选项。
2. get_resource：获取特定资源的详细信息。
3. download_resource：获取特定资源的下载 URL。
4. generate_image：使用 Mystic AI 生成图像。
5. check_status：检查 AI 图像生成任务的状态。

常见问题解答

• 如何获取 API Key：参考 API Setup Guide。
• 错误处理：服务器实现了全面的错误处理，包括 API 错误日志、输入验证和错误响应。

使用教程

使用依赖

• Node.js 18 或更高版本
• Freepik API Key

安装教程

# 创建 MCP 服务器目录
mkdir mcp-servers
cd mcp-servers

# 克隆仓库
git clone https://github.com/MCERQUA/freepik-mcp.git
cd freepik-mcp

# 安装依赖
npm install

# 构建服务器
npm run build

配置

1. 获取 Freepik API Key。
2. 将服务器添加到 MCP 设置文件中：

{
  "mcpServers": {
    "freepik": {
      "command": "node",
      "args": ["path/to/freepik-mcp/build/index.js"],
      "env": {
        "FREEPIK_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

调试方式

# 开发模式运行
npm run dev

许可证

该项目遵循 MIT 开源许可条款。