Unsplash MCP Server

Unsplash MCP Server

site icon
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 或更高版本。

安装教程

下载预编译二进制文件

  1. GitHub Releases 下载适用于您平台的最新预编译二进制文件。
  2. 解压并安装到本地 bin 目录。

从源代码构建

  1. 克隆仓库: bash git clone https://github.com/okooo5km/unsplash-mcp-server-go.git cd unsplash-mcp-server-go
  2. 构建项目: bash make
  3. 安装二进制文件: bash mkdir -p ~/.local/bin cp unsplash-mcp-server ~/.local/bin/

调试方式

  1. 设置环境变量: bash export UNSPLASH_ACCESS_KEY="your-access-key-here"
  2. 启动服务: bash unsplash-mcp-server
  3. 使用命令行参数调试: bash unsplash-mcp-server --help unsplash-mcp-server --version unsplash-mcp-server --transport sse --port 9090

许可证

该项目遵循 None 开源许可条款。