Unsplash MCP 服务器

这是一个提供 Unsplash 图片搜索和检索能力的 Model Context Protocol 服务器。该服务器使 LLM 能够在 Unsplash 的庞大图片库中进行搜索、检索和获取随机图片。这是一个用 Go 实现的工具，提供了诸如 search_photos、get_photo 和 random_photo 等功能。

✨ 特性

• 高级图像搜索：通过以下过滤器搜索 Unsplash 的广泛照片库：
  • 关键词相关性
  • 颜色方案
  • 方向选项
  • 自定义排序和分页
• 详细照片信息：获取特定照片的全面详情，包括 EXIF 数据、位置和摄影师信息
• 随机照片选择：带有灵活过滤选项的随机照片
• 多种连接模式：
  • 标准 I/O 模式，用于与 LLM 直接集成
  • Server-Sent Events (SSE) 模式，用于基于 Web 的连接

可用工具

• search_photos - 在 Unsplash 上搜索照片

  • query (字符串，必需)：搜索关键词
  • page (数字，可选)：页面编号（从 1 开始），默认值：1
  • per_page (数字，可选)：每页结果数（1-30），默认值：10
  • order_by (字符串，可选)：排序方法（relevant 或 latest），默认值："relevant"
  • color (字符串，可选)：颜色过滤器（black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue）
  • orientation (字符串，可选)：方向过滤器（landscape, portrait, squarish）

• get_photo - 获取特定照片的详细信息

  • photoId (字符串，必需)：要检索的照片 ID

• random_photo - 获取一个或多个随机照片

  • count (数字，可选)：返回的照片数量（默认值：1；最大值：30）
  • collections (字符串，可选)：用于筛选选择的公共集合 ID（如果多个，则逗号分隔）
  • topics (字符串，可选)：用于筛选选择的公共主题 ID（如果多个，则逗号分隔）
  • username (字符串，可选)：限制选择到特定用户
  • query (字符串，可选)：限制选择到匹配搜索词的照片
  • orientation (字符串，可选)：按照片方向过滤。有效值：landscape, portrait, squarish
  • content_filter (字符串，可选)：按内容安全性限制结果。有效值：low, high
  • featured (布尔值，可选)：限制选择到特色照片

安装

选项 1：下载预构建二进制文件

从 GitHub Releases 页面下载适用于您平台的最新预构建二进制文件，并按照下面的安装说明操作。

<details> <summary><b>macOS 安装</b></summary>

macOS 带有 Apple Silicon (M1/M2/M3)：

# 下载 arm64 版本
curl -L https://github.com/okooo5km/unsplash-mcp-server-go/releases/latest/download/unsplash-mcp-server-macos-arm64.zip -o unsplash-mcp-server.zip
unzip unsplash-mcp-server.zip
chmod +x unsplash-mcp-server

# 移除隔离属性以避免安全警告
xattr -d com.apple.quarantine unsplash-mcp-server

# 安装到本地 bin 目录
mkdir -p ~/.local/bin
mv unsplash-mcp-server ~/.local/bin/
rm unsplash-mcp-server.zip

macOS 带有 Intel 处理器：

# 下载 x86_64 版本
curl -L https://github.com/okooo5km/unsplash-mcp-server-go/releases/latest/download/unsplash-mcp-server-macos-x86_64.zip -o unsplash-mcp-server.zip
unzip unsplash-mcp-server.zip
chmod +x unsplash-mcp-server

# 移除隔离属性以避免安全警告
xattr -d com.apple.quarantine unsplash-mcp-server

# 安装到本地 bin 目录
mkdir -p ~/.local/bin
mv unsplash-m[...]