MCP.so
Sign In

Unsplash MCP Server

@shariqriazz

Repository

About Unsplash MCP Server

No overview available yet

Basic information

Category

Other

License

MIT

Runtime

node

Transports

stdio

Publisher

shariqriazz

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "upsplash-mcp-server": {
      "command": "bun",
      "args": [
        "run",
        "build"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Unsplash MCP Server?

Unsplash MCP Server is a Model Context Protocol (MCP) server that provides tools for interacting with the Unsplash API, allowing users to search for and download photos.

How to use Unsplash MCP Server?

Requires Node.js v18+, Bun, and an Unsplash Access Key. Set up by cloning the repo, installing dependencies with bun install, configuring .env with UNSPLASH_ACCESS_KEY, then building with bun run build. Run standalone with bun run build/index.js. For use with Cline, configure MCP settings with the command and environment variable.

Key features of Unsplash MCP Server?

  • Provides MCP tools to interact with the Unsplash API
  • Search for photos based on query, pagination, and orientation
  • Download photos at specified resolutions (raw, full, regular, small)
  • Requires Unsplash Access Key configured via environment variable
  • Downloads photos to a local unsplash/ directory within the workspace
  • Provides two tools: search_photos and download_photo

Use cases of Unsplash MCP Server?

  • Search for stock photos by keyword, page, and orientation for content creation
  • Download high-resolution images directly into project workspaces
  • Integrate Unsplash photo search and retrieval into AI assistants via MCP
  • Automate photo sourcing for design or development workflows

FAQ from Unsplash MCP Server

What are the prerequisites for running the server?

Node.js v18+, Bun (npm install -g bun), and an Unsplash account with an API Access Key from unsplash.com/developers.

How do I configure the Unsplash API key?

Create a .env file in the project root with UNSPLASH_ACCESS_KEY="YOUR_KEY" or set the environment variable in your shell or MCP configuration.

Where are downloaded photos saved?

Photos are saved to an unsplash/ directory within the current workspace.

What is the maximum number of items per page when searching?

The per_page parameter has a maximum value of 30.

Do I need an Unsplash API key to use the server?

Yes, a valid Unsplash Access Key configured via the UNSPLASH_ACCESS_KEY environment variable is required.

Comments

More Other MCP servers

Awesome Mcp Servers

punkpeye

A collection of MCP servers.

90.5K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

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