MCP.so
登录

Unsplash Mcp

@cevatkerim

代码仓库

关于 Unsplash Mcp

An MCP server for Unsplash photo search with proper attribution built-in. Key differentiator: Returns ready-to-use attribution_text and attribution_html for each photo, making it trivial for LLMs to build content pages with properly credited images (as required by Unsplash API g

#unsplash#images#photos#stock-photos#attribution#mcp#fastmcp#python#llm#content#search

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

cevatkerim

提交者

Kerim Incedayi

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "unsplash": {
      "type": "stdio",
      "command": "/path/to/unsplash-mcp/.venv/bin/fastmcp",
      "args": [
        "run",
        "/path/to/unsplash-mcp/server.py"
      ],
      "env": {
        "UNSPLASH_ACCESS_KEY": "your_access_key_here"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Unsplash Mcp?

An MCP (Model Context Protocol) server for fetching photos from Unsplash with proper attribution. It is designed for LLMs building content pages that need properly credited images.

How to use Unsplash Mcp?

Install Python 3.11+, obtain an Unsplash API access key, clone the repository, create a virtual environment, install dependencies (fastmcp, httpx, python-dotenv), set the key in a .env file, then run the server with fastmcp run server.py. Configure the server in your MCP client (e.g., Claude Code, Cursor, Windsurf/Cline) by providing the command path, arguments, and the UNSPLASH_ACCESS_KEY environment variable.

Key features of Unsplash Mcp

  • Search photos by keyword with filters (color, orientation)
  • Get random photos for variety in content
  • Download tracking compliant with Unsplash API guidelines
  • Full attribution including ready-to-use text and HTML
  • Pre-formatted attribution strings optimized for LLM embedding

Use cases of Unsplash Mcp

  • An LLM building a blog post includes credited landscape photos
  • A content-generation app selects a random nature image for a hero section
  • A website generator searches for coffee shop images and embeds attribution HTML
  • An AI assistant tracks downloads when a user saves an image

FAQ from Unsplash Mcp

What do I need to run Unsplash Mcp?

Python 3.11+ and an Unsplash API access key (available from unsplash.com/developers). Dependencies include fastmcp, httpx, and python-dotenv.

What are the rate limits?

Demo mode: 50 requests per hour. Production mode: 5,000 requests per hour (after approval).

Does the server handle Unsplash attribution requirements?

Yes. Every photo response includes attribution_text and attribution_html strings. You must use these when displaying images.

Can I hotlink images from Unsplash using this server?

Yes. The returned URLs are meant to be used directly, which enables view tracking in compliance with Unsplash API guidelines.

Do I need to track downloads?

Yes, if you offer a download link. Use the track_download tool with the photo ID to comply with Unsplash API guidelines.

评论

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

Awesome-MCP-ZH

yzfly

MCP 资源精选， MCP指南，Claude MCP，MCP Servers, MCP Clients

7.4K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K