unsplash-mcp-server

[](https://mseep.ai/app/hellokaton-unsplash-mcp-server) # Unsplash MCP Server English | [简体中文](README_zh.md) > A simple MCP server for seamless Unsplash image integration and search capabilities. [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://smithery.ai/server/@hellokaton/unsplash-mcp-server) ## 📋 Overview Unsplash MCP Server is used for searching rich, high-quality images. It's ideal for developers who want to integrate Unsplash functionality into their own applications. ## ✨ Features - **Advanced Image Search**: Search Unsplash's extensive photo library with filters for: - Keyword relevance - Color schemes - Orientation options - Custom sorting and pagination ## 🔑 Obtaining Unsplash Access Key Before installing this server, you'll need to obtain an Unsplash API Access Key: 1. Create a developer account at [Unsplash](https://unsplash.com/developers) 2. Register a new application 3. Get your Access Key from the application details page 4. Use this key in the configuration steps below For more details, refer to the [official Unsplash API documentation](https://unsplash.com/documentation). ## 🚀 Installation To install Unsplash Image Integration Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hellokaton/unsplash-mcp-server): ### IDE Setup **Cursor IDE** ```bash npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key 7558c683-****-**** ``` **Windsurf** ```bash npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-**** ``` **Cline** ```bash npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-**** ``` ### Manual Installation ```bash # Clone the repository git clone https://github.com/hellokaton/unsplash-mcp-server.git # Navigate to project directory cd unsplash-mcp-server # Create virtual environment uv venv # Install dependencies uv pip install . ``` **Cursor Editor Integration** Add the following configuration to your Cursor editor's `settings.json`: ⚠️ **Note:** Please adjust the following configuration according to your actual installation: - If `uv` is not in your system PATH, use an absolute path (e.g., `/path/to/uv`) - `./server.py` should be modified to the actual location of your server script (can use absolute path or path relative to workspace) <img src="screenshots/Snipaste_1.png" alt="Cursor Configuration Screenshot" /> ```json { "mcpServers": { "unsplash": { "command": "uv", "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"], "env": { "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}" } } } } ``` ### Using in Cursor <img src="screenshots/Snipaste_2.png" alt="Unsplash MCP in Cursor" /> ## 🛠️ Available Tools ### Search Photos ```json { "tool": "search_photos", "query": "mountain", "per_page": 5, "orientation": "landscape" } ``` ## 🔄 Other Implementations - Golang: [unsplash-mcp-server](https://github.com/douglarek/unsplash-mcp-server) - Java: [unsplash-mcp-server](https://github.com/JavaProgrammerLB/unsplash-mcp-server) ## 📄 License [MIT License](LICENSE) ## 📬 Contact - [Twitter/X](https://x.com/hellokaton) - [GitHub Issues](https://github.com/hellokaton/unsplash-mcp-server/issues)