
Unsplash MCP Server

2025.04.16
7
Go图片搜索图片检索内容生成
Unsplash MCP Server 是一个基于 Model Context Protocol 的服务,提供 Unsplash 图片搜索和检索功能。该服务使 LLMs 能够从 Unsplash 的庞大图库中搜索、检索和获取随机图片。这是一个 Go 实现,提供了 `search_photos`、`get_photo` 和 `random_photo` 等工具。
View on GitHub
Overview
基本能力
产品定位
Unsplash MCP Server 是一个专门用于图片搜索和检索的服务,旨在为 LLMs 提供高质量的图片资源。
核心功能
- 高级图片搜索:支持关键词相关性、颜色方案、方向选项等过滤条件。
- 详细图片信息:获取包括 EXIF 数据、位置和摄影师信息在内的详细图片信息。
- 随机图片选择:支持多种过滤选项的随机图片获取。
- 多种连接模式:支持标准 I/O 模式和 Server-Sent Events (SSE) 模式。
适用场景
- 需要高质量图片资源的 LLMs 应用。
- 图片搜索和检索的自动化工具。
- 需要随机图片的应用场景。
工具列表
search_photos
:搜索 Unsplash 上的图片,支持多种过滤条件。get_photo
:获取特定图片的详细信息。random_photo
:获取随机图片,支持多种过滤选项。
常见问题解答
- 需要 Unsplash API 访问密钥才能使用该服务。
- 支持多种平台(macOS、Linux、Windows)的安装和运行。
使用教程
使用依赖
- Go 1.20 或更高版本。
- Unsplash API 访问密钥。
- MCP Go SDK 0.19.0 或更高版本。
安装教程
下载预编译二进制文件
- 从 GitHub Releases 下载适用于您平台的最新预编译二进制文件。
- 解压并安装到本地 bin 目录。
从源代码构建
- 克隆仓库:
bash git clone https://github.com/okooo5km/unsplash-mcp-server-go.git cd unsplash-mcp-server-go
- 构建项目:
bash make
- 安装二进制文件:
bash mkdir -p ~/.local/bin cp unsplash-mcp-server ~/.local/bin/
调试方式
- 设置环境变量:
bash export UNSPLASH_ACCESS_KEY="your-access-key-here"
- 启动服务:
bash unsplash-mcp-server
- 使用命令行参数调试:
bash unsplash-mcp-server --help unsplash-mcp-server --version unsplash-mcp-server --transport sse --port 9090