Unsplash Smart MCP Server logo

Unsplash Smart MCP Server

by drumnation

The Unsplash Smart MCP Server empowers AI agents with stunning visuals by enabling them to seamlessly search, recommend, and deliver professional stock photos from Unsplash. It offers intelligent context awareness and automated attribution management.

View on GitHub

Last updated: N/A

What is Unsplash Smart MCP Server?

A FastMCP server that allows AI agents to find and use Unsplash images with context awareness and automated attribution. It streamlines the process of image acquisition for AI agents, ensuring compliance with Unsplash's terms of service.

How to use Unsplash Smart MCP Server?

The server can be installed locally, via Docker, or through Smithery. Once installed, configure your Cursor MCP settings to point to the server. Then, ask your AI agent (like Claude in Cursor) for an image using natural language prompts. The server handles the image search, download (optional), and attribution automatically.

Key features of Unsplash Smart MCP Server

  • AI-Agent Optimized for seamless integration

  • Context-Aware Image Selection for relevant results

  • Automatic Attribution to comply with Unsplash's terms

  • Project-Aware Organization for easy file management

Use cases of Unsplash Smart MCP Server

  • Populating UI mockups with relevant images

  • Enhancing technical documentation with visuals

  • Finding images for blog posts and articles

  • Creating visually rich user experiences in applications

FAQ from Unsplash Smart MCP Server

What is an MCP server?

MCP stands for Machine Communication Protocol. It's a way for AI agents to communicate with external tools and services.

Do I need to pay for Unsplash API access?

Unsplash offers a free API tier with rate limits. For higher usage, you may need a paid plan.

How do I get an Unsplash API key?

You can get an API key by creating a developer account on the Unsplash website (unsplash.com/developers).

What if I get a 'Client closed' error on Windows?

This is a known issue. Follow the Windows-specific configuration steps in the README, using either the direct Node execution or PowerShell approach.

How do I ensure proper attribution?

The server automatically captures and embeds attribution data. You can use the API to generate attribution files in JSON, HTML, or React formats.