Unsplash MCP Server

Unsplash MCP 服务器是一个功能强大的MCP工具，旨在帮助开发者无缝集成Unsplash的图像搜索功能。通过该服务器，用户可以基于关键词、颜色、方向等条件搜索高质量图片，并支持分页和排序功能，适用于需要丰富图片资源的各类应用程序。

核心功能

Unsplash MCP 服务器提供以下核心功能，帮助用户高效获取所需图片资源：

• 高级图像搜索：支持关键词、颜色方案、方向等多种过滤条件，帮助用户快速定位所需图片。
• 自定义排序与分页：用户可以根据需求对搜索结果进行排序，并支持分页查看，提升搜索效率。
• 快速集成：服务器设计简洁，易于集成到现有系统中，开发者只需几步即可完成配置和部署。

安装方法

安装Unsplash MCP 服务器可以通过手动安装或通过Smithery平台进行集成。以下是手动安装的步骤：

git clone https://github.com/hellokaton/unsplash-mcp-server.git

cd unsplash-mcp-server

uv venv

uv pip install .

此外，也可以通过Smithery平台进行安装，适用于Cursor、Windsurf、Cline等编辑器环境。

使用方法

使用Unsplash MCP 服务器前，需要先获取Unsplash API的访问密钥。以下是使用示例：

search_photos query='nature' per_page=10 orientation='landscape'

该命令将返回10张与“自然”相关的高质量图片，且图片方向为横向。

search_photos query='city' per_page=5

该命令将返回5张与“城市”相关的图片。

配置说明

在Cursor IDE中使用该服务器时，需要在 `settings.json` 中添加以下配置：

{
  "mcpServers": {
    "unsplash": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
      }
    }
  }
}

请根据实际安装路径调整 `uv` 和 `./server.py` 的路径。

使用场景

Unsplash MCP 服务器适用于以下应用场景：

• 社交媒体平台：为用户提供丰富的图片资源，增强内容创作能力。
• 在线编辑器：集成高质量图片搜索功能，提升用户编辑体验。
• 展示型网站：快速获取高质量图片，用于产品展示或视觉设计。

注意事项

在使用Unsplash MCP 服务器时，需注意以下事项：

• 必须拥有有效的Unsplash API访问密钥。
• 服务器依赖网络环境，需确保网络连接稳定。
• 目前仅支持英文搜索，未来版本可能增加多语言支持。

Unsplash MCP 服务器通过简洁的设计和强大的搜索功能，为开发者提供了一个高效集成Unsplash图片资源的解决方案，适用于多种应用场景。