upsplash-mcp-server
1
The Unsplash MCP Server is a tool for interfacing with the Unsplash API to search and download photos conveniently through a Model Context Protocol (MCP) server setup. It features photo searching and downloading functionalities, requiring an Unsplash Access Key and setup via environment configurations.
Unsplash MCP Server
This project implements a Model Context Protocol (MCP) server to interact with the Unsplash API. It allows users to search for and download photos using tools that provide features such as specifying search queries and downloading images in various resolutions. Environment configuration requires an Unsplash Access Key.
Features
- Interaction with Unsplash API via MCP
- Photo search with query, pagination, and orientation
- Downloads photos to local unsplash/ directory
- Requires Unsplash Access Key via environment variables
Prerequisites
- Node.js v18+
- Bun (install via npm)
- Unsplash Account and API Access Key
Setup & Installation
- Clone the repository
- Install dependencies
- Configure the environment with Unsplash Access Key
- Build the server using Bun
Usage
- Run the compiled server locally using Bun or Node
- Use NPX if the package is published
Running with Cline
- Configure MCP settings
- Use Bun/Node for local development or NPX for npm version
- Restart/Reload Cline to apply changes
Development
- Watch mode for automatic restart on changes
- Linting and formatting scripts available
License
Licensed under the MIT License.