Freepik MCP 服务器

一个用于与 Freepik API 交互的 MCP 服务器实现，提供对库存照片和 Mystic AI 图像生成功能的访问。

功能

• 搜索 Freepik 资源（照片、矢量图、PSD）
• 获取详细的资源信息
• 下载资源
• 使用 Mystic AI 生成图像
• 检查图像生成状态

前提条件

• Node.js 18 或更高版本
• 一个 Freepik API 密钥（参见 API 设置指南）

安装

# 为您的 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. 首先，按照 API_SETUP.md 中的说明获取您的 Freepik API 密钥。

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": []
    }
  }
}

可用工具

search_resources

使用各种过滤器搜索 Freepik 资源：

{
  term?: string;          // 搜索词
  limit?: number;         // 每页结果数
  order?: 'relevance' | 'recent';
  filters?: {
    orientation?: {
      landscape?: boolean;
      portrait?: boolean;
      square?: boolean;
      panoramic?: boolean;
    };
    content_type?: {
      photo?: boolean;
      psd?: boolean;
      vector?: boolean;
    };
    license?: {
      freemium?: boolean;
      premium?: boolean;
    };
  };
}

get_resource

获取有关特定资源的详细信息：

{
  id: number;  // 要获取详细信息的资源 ID
}

download_resource

获取特定资源的下载 URL：

{
  id: number;  // 要下载的资源 ID
}

generate_image

使用 Freepik Mystic AI 生成图像：

{
  prompt: string;         // 要生成的图像的文本描述
  resolution?: '2k' | '4k';
  aspect_ratio?: 'square_1_1' | 'classic_4_3' | 'traditional_3_4' | 
                 'widescreen_16_9' | 'social_story_9_16';
  realism?: boolean;      // 启用逼真风格
  engine?: 'automatic' | 'magnific_illusio' | 'magnific_sharpy' | 'magnific_sparkle';
  creative_detailing?: number;  // 0-100
}

check_status

检查 Mystic 图像生成任务的状态：

{
  task_id: string;  // 要检查的生成任务的 ID
}

开发

# 安装依赖
npm install

# 构建服务器
npm run build

# 在开发模式下运行
npm run dev

错误处理

服务器实现了全面的错误处理：

• API 错误会被记录详细信息
• 使用 Zod 模式进行输入验证
• 正确的错误响应和上下文
• 速率限制感知

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

MIT