使用说明

Freepik MCP

🚀 用于无缝集成Freepik API的MCP服务器

🎯 这是什么？

A. 模型上下文协议（MCP）服务器 它将您的AI助手（Claude、Cursor等）直接与Freepik强大的API连接起来。在不离开人工智能工作流程的情况下生成、搜索和管理视觉内容。

🛠️ 有哪些可用的工具？

🎨 图标搜索和下载 -查找并下载多种格式的图标
📁 资源管理 -访问和管理多媒体内容
🤖 AI图像分类 -自动对图像进行分类和分析
🖼️ 图像生成 -使用Mystic AI创建自定义图像

📋 先决条件

在开始之前，请确保您已经：

Python 3.12+ 安装
紫外线 依赖关系管理器(在此处安装)
Freepik API密钥 (在这里买你的)

🚀 安装

1.克隆和导航

git clone <REPOSITORY_URL>
cd freepik-mcp

2.使用Makefile安装

# Install dependencies
make install

# Verify installation
make version

3.配置API密钥

echo "FREEPIK_API_KEY=your_api_key_here" > .env

💡 获取API密钥： freepik.com/api

⚙️ AI助手的配置

适用于Linux上的Claude桌面或光标

将此添加到您的 config.json 文件：

⚠️ 对于Windows用户： 如果您使用的是Windows，则需要使用WSL（Linux的Windows子系统）来运行此MCP服务器。

{
  "mcpServers": {
    "freepik-fastmcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/FULL/PATH/TO/freepik-mcp",
        "main.py"
      ],
      "env": {
        "FREEPIK_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

🔧 重要配置步骤

找到你的完整路径：

pwd
# Copy the output and replace /FULL/PATH/TO/ in the config

替换为API密钥：
- 从以下地址获取 freepik.com/api
- 替换 your_actual_api_key_here

🏃‍♂️ 快速开始

# Development mode (auto-reload)
make dev

# Production mode
make run

# Check code quality
make lint

# Format code
make format

# Clean temporary files
make clean

# See all commands
make help

🤝 贡献

我们欢迎捐款！请遵循以下指南：

📝 承诺公约

此项目使用 约定式提交.将您的提交格式设置为：

<type>(<scope>): <description>

[optional body]

[optional footer(s)]

类型：

feat：新功能
fix：Bug修复
docs：文件更改
style：代码样式更改（格式等）
refactor：代码重构
test：添加或更新测试
chore：维护任务

示例：

feat(icons): add search filtering by category
fix(api): resolve authentication timeout issue
docs(readme): update installation instructions
refactor(mystic): improve error handling logic

🔄 贡献工作流程

分叉存储库
创建特征分支： git checkout -b feat/amazing-feature
提交使用传统格式： git commit -m "feat: add amazing feature"
推到您的分行： git push origin feat/amazing-feature
打开拉取请求

📚 开发命令

命令	描述
`make help`	显示所有可用命令
`make install`	安装依赖项
`make dev`	以开发模式运行
`make run`	在生产模式下运行
`make lint`	检查代码质量
`make format`	自动格式化代码
`make clean`	清理临时文件
`make version`	检查FastMCP版本

🛡️ 安全

⚠️ 永远不要提交API密钥
✅ 使用 .env 敏感数据文件
✅ 这 .env 文件在 .gitignore

📖 API 文档

有关API的详细信息：

Freepik API文档

🆘 故障排除

常见问题：

“找不到命令” → 安装 uv 依赖关系管理器
“无效的API密钥” → 检查您的钥匙 freepik.com/api
“找不到路径” → 验证配置中的完整路径
“连接被拒绝” → 确保服务器正在运行 make dev

还有问题吗？ 在GitHub上打开一个问题：

您的操作系统和Python版本
完整错误消息
配置文件（不带API密钥）