Unsplash MCP Server

基本能力

产品定位

Unsplash MCP Server 主要用于搜索丰富、高质量的图片，帮助开发者轻松集成 Unsplash 功能到自己的应用中。

核心功能

• 高级图片搜索：可以搜索 Unsplash 的庞大图片库，支持以下过滤器：
• 关键词相关性
• 配色方案
• 方向选项
• 自定义排序和分页

适用场景

• 开发者需要在应用中集成高质量图片搜索功能
• 需要根据特定条件（如颜色、方向等）筛选图片的应用
• 需要分页展示图片的应用

工具列表

• Search Photos：用于搜索 Unsplash 图片的工具，支持查询关键词、每页数量和方向等参数。

常见问题解答

1. 如何获取 Unsplash Access Key？
2. 创建开发者账号于 Unsplash
3. 注册新应用
4. 从应用详情页面获取 Access Key
5. 在配置步骤中使用此密钥

使用教程

使用依赖

• Python 3.9+
• Unsplash API Access Key

安装教程

自动安装（通过 Smithery）

Cursor IDE

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Windsurf

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Cline

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

手动安装

# 克隆仓库
git clone https://github.com/hellokaton/unsplash-mcp-server.git

# 进入项目目录
cd unsplash-mcp-server

# 创建虚拟环境
uv venv

# 安装依赖
uv pip install .

调试方式

1. 确保已正确配置 Unsplash Access Key
2. 使用提供的工具进行图片搜索测试
3. 检查返回的图片数据是否符合预期

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。