Freepik MCP
🚀 用于无缝集成Freepik API的MCP服务器
🎯 这是什么？
A. 模型上下文协议（MCP）服务器 它将您的AI助手（Claude、Cursor等）直接与Freepik强大的API连接起来。在不离开人工智能工作流程的情况下生成、搜索和管理视觉内容。
🛠️ 有哪些可用的工具？
- 🎨 图标搜索和下载 -查找并下载多种格式的图标
- 📁 资源管理 -访问和管理多媒体内容
- 🤖 AI图像分类 -自动对图像进行分类和分析
- 🖼️ 图像生成 -使用Mystic AI创建自定义图像
📋 先决条件
在开始之前，请确保您已经：
🚀 安装
1.克隆和导航
git clone
cd freepik-mcp2.使用Makefile安装
# Install dependencies
make install
# Verify installation
make version3.配置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🤝 贡献
我们欢迎捐款！请遵循以下指南：
📝 承诺公约
此项目使用 约定式提交.将您的提交格式设置为：
():
[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的详细信息：
🆘 故障排除
常见问题：
- “找不到命令” → 安装
uv依赖关系管理器 - “无效的API密钥” → 检查您的钥匙 freepik.com/api
- “找不到路径” → 验证配置中的完整路径
- “连接被拒绝” → 确保服务器正在运行
make dev
还有问题吗？ 在GitHub上打开一个问题：
- 您的操作系统和Python版本
- 完整错误消息
- 配置文件（不带API密钥）
______________________________________________________________________
准备好用人工智能创造精彩内容了吗？ 🎨✨