Unsplash MCP Server
2025.04.16
7
Go图片搜索图片检索Unsplash API内容生成
Unsplash MCP Server 是一个基于 Model Context Protocol 的服务，提供 Unsplash 图片搜索和检索功能。该服务使 LLMs 能够搜索、检索和获取 Unsplash 庞大图库中的随机图片。这是 Python 版本的 Swift 实现，并增加了 `get_photo` 和 `random_photo` 等额外功能。
View on GitHub
Overview
基本能力
产品定位
Unsplash MCP Server 是一个专门用于图片搜索和检索的服务，旨在为开发者和 LLMs 提供便捷的 Unsplash 图片访问能力。
核心功能
- 高级图片搜索：支持关键词相关性、色彩方案、方向选项、自定义排序和分页等过滤条件。
- 详细图片信息：获取特定图片的详细信息，包括 EXIF 数据、位置和摄影师信息。
- 随机图片选择：提供灵活的过滤选项来获取随机图片。
适用场景
- 需要从 Unsplash 获取高质量图片的应用开发。
- 为 LLMs 提供图片搜索和检索功能。
- 需要随机图片展示的应用场景。
工具列表
search_photos：搜索 Unsplash 上的图片，支持多种过滤条件。get_photo：获取特定图片的详细信息。random_photo：获取一张或多张随机图片，支持多种过滤选项。
常见问题解答
- 需要 Unsplash API 访问密钥才能使用该服务。
- 安装时需确保
~/.local/bin在 PATH 中。
使用教程
使用依赖
- Swift 6.0 或更高版本。
- macOS 14.0 或更高版本。
- Unsplash API 访问密钥。
- MCP Swift SDK 0.2.0 或更高版本。
安装教程
选项1：一键安装（curl）
curl -fsSL https://raw.githubusercontent.com/okooo5km/unsplash-mcp-server-swift/main/install.sh | bash
选项2：从源码构建
- 克隆仓库：
git clone https://github.com/okooo5km/unsplash-mcp-server-swift.git
cd unsplash-mcp-server-swift
- 构建项目：
swift build -c release
- 安装二进制文件：
mkdir -p ~/.local/bin
cp $(swift build -c release --show-bin-path)/unsplash-mcp-server ~/.local/bin/
- 确保
~/.local/bin在 PATH 中：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # or ~/.bashrc
source ~/.zshrc # or source ~/.bashrc
调试方式
- 设置环境变量：
export UNSPLASH_ACCESS_KEY="your-access-key-here"
- 运行服务：
unsplash-mcp-server
- 检查日志输出以确保服务正常运行。