AI导哈

Freepik资源服务器

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

  • by MCERQUA
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 MCERQUA/freepik-mcp

使用说明

Freepik MCP服务器

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

特性

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

先决条件

安装

# Create a new directory for your MCP servers
mkdir mcp-servers
cd mcp-servers

# Clone the repository
git clone https://github.com/MCERQUA/freepik-mcp.git
cd freepik-mcp

# Install dependencies
npm install

# Build the server
npm run build

配置

  1. 首先，按照中的说明获取Freepik API密钥 API_SETUP.md

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

可用工具

搜索资源

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

{
  term?: string;          // Search term
  limit?: number;         // Results per page
  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;
    };
  };
}

获取资源

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

{
  id: number;  // Resource ID to get details for
}

下载_资源

获取特定资源的下载URL：

{
  id: number;  // Resource ID to download
}

generate_image

使用Freepik Mystic AI生成图像：

{
  prompt: string;         // Text description of the image to generate
  resolution?: '2k' | '4k';
  aspect_ratio?: 'square_1_1' | 'classic_4_3' | 'traditional_3_4' | 
                 'widescreen_16_9' | 'social_story_9_16';
  realism?: boolean;      // Enable realistic style
  engine?: 'automatic' | 'magnific_illusio' | 'magnific_sharpy' | 'magnific_sparkle';
  creative_detailing?: number;  // 0-100
}

check_status

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

{
  task_id: string;  // ID of the generation task to check
}

发展

# Install dependencies
npm install

# Build the server
npm run build

# Run in development mode
npm run dev

错误处理

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

  • API错误记录有详细信息
  • 使用Zod模式进行输入验证
  • 正确的错误响应与上下文
  • 限速意识

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

麻省理工学院

相关 MCP