MCP.so
登录

Unsplash MCP Server

@okooo5km

基本信息

分类

其他

传输方式

stdio

作者

okooo5km

关于 Unsplash MCP Server

a Swift implementation of hellokaton/unsplash-mcp-server, with additional features like get_photo and random_photo

Unsplash MCP Server 配置

暂无标准配置

该服务器的 README 中没有可解析的 MCP 配置块,请前往代码仓库查看安装说明。

代码仓库

Unsplash MCP Server 工具

3

Search for photos on Unsplash

Get detailed information about a specific photo

Get one or more random photos

概览

What is Unsplash MCP Server?

A Model Context Protocol server that provides Unsplash photo search and retrieval capabilities. It enables LLMs to search, retrieve, and get random photos from Unsplash's extensive collection. The server is implemented in Go and exposes tools like search_photos, get_photo, and random_photo.

How to use Unsplash MCP Server?

Install via pre-built binary or build from source (Go 1.20+). Set the UNSPLASH_ACCESS_KEY environment variable with your Unsplash API Access Key. Run the server with unsplash-mcp-server (default stdio mode) or with --transport sse for web-based connections. Configure as an MCP server in Claude.app, Cursor, or Chatwise by specifying the command and environment variable.

Key features of Unsplash MCP Server

  • Advanced image search with keyword, color, orientation, sorting, and pagination
  • Detailed photo information including EXIF data, location, and photographer
  • Random photo selection with flexible filtering options
  • Multiple connection modes: Standard I/O and Server-Sent Events (SSE)
  • Support for macOS, Linux, and Windows platforms

Use cases of Unsplash MCP Server

  • Search for photos by keyword, color, or orientation for visual content needs
  • Retrieve detailed metadata about a specific photo (EXIF, location, photographer)
  • Get random photos filtered by topics, collections, username, or content safety
  • Integrate Unsplash image search directly into LLM chat applications via MCP

常见问题

1

What is required to run Unsplash MCP Server?

You need an Unsplash API Access Key (register at the Unsplash Developers Portal) and set it as the `UNSPLASH_ACCESS_KEY` environment variable. The server can run as a pre-built binary or built from source with Go 1.20 or later.

2

How do I switch between stdio and SSE modes?

Use the `--transport` command line argument: `unsplash-mcp-server` for standard I/O (default), or `unsplash-mcp-server --transport sse` for Server-Sent Events. In SSE mode you can also set the port with `--port`.

3

What tools does Unsplash MCP Server provide?

It provides three tools: `search_photos` (search with filters), `get_photo` (get photo details by ID), and `random_photo` (get random photos with optional filters).

4

Can I get random photos filtered by topic or collection?

Yes. The `random_photo` tool accepts `collections`, `topics`, `username`, `query`, `orientation`, `content_filter`, and `featured` parameters.

5

Does the server support Windows?

Yes. Pre-built binaries are available for Windows x86_64 and ARM64. Installation instructions are provided in the README.

评论

其他 分类下的更多 MCP 服务器