Skip to main content
Glama
MCERQUA

Freepik MCP Server

Freepik MCP 服务器

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

特征

  • 搜索 Freepik 资源(照片、矢量图、PSD)

  • 获取详细资源信息

  • 下载资源

  • 使用 Mystic AI 生成图像

  • 检查图像生成状态

Related MCP server: Freepik FastMCP Toolkit

先决条件

安装

# 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. 首先,按照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": []
    }
  }
}

可用工具

搜索资源

使用各种过滤器搜索 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
}

生成图像

使用 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
}

检查状态

检查 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. 打开拉取请求

执照

麻省理工学院

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MCERQUA/freepik-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server