{"type":"mcp_server","name":"unsplash-mcp-server","description":"The Unsplash MCP Server provides seamless integration and search capabilities for Unsplash images, allowing developers to easily incorporate high-quality visuals into their applications with advanced search filters. The Unsplash MCP","category":"Developer Tools","language":"Python","stars":226,"forks":10,"owner":"hellokaton","github_url":"https://github.com/hellokaton/unsplash-mcp-server","homepage":null,"setup":"## Setup\n\nBefore installing this server, you'll need to obtain an Unsplash API Access Key:\n\n1.  Create a developer account at [Unsplash](https://unsplash.com/developers)\n2.  Register a new application\n3.  Get your Access Key from the application details page\n4.  Use this key in the configuration steps below\n\nTo install Unsplash Image Integration Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hellokaton/unsplash-mcp-server):\n\n### IDE Setup\n\n**Cursor IDE**\n\n```bash\nnpx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --config \"{\\\"unsplashAccessKey\\\":\\\"YOUR_ACCESS_KEY\\\"}\"\n```\n\n**Windsurf**\n\n```bash\nnpx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --config \"{\\\"unsplashAccessKey\\\":\\\"YOUR_ACCESS_KEY\\\"}\"\n```\n\n**Cline**\n\n```bash\nnpx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --config \"{\\\"unsplashAccessKey\\\":\\\"YOUR_ACCESS_KEY\\\"}\"\n```\n\n### Manual Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/hellokaton/unsplash-mcp-server.git\n\n# Navigate to project directory\ncd unsplash-mcp-server\n\n# Create virtual environment\nuv venv\n\n# Install dependencies\nuv pip install .\n```\n\n**Cursor Editor Integration**\n\nAdd the following configuration to your Cursor editor's `settings.json`:\n\n⚠️ **Note:** Please adjust the following configuration according to your actual installation:\n\n- If `uv` is not in your system PATH, use an absolute path (e.g., `/path/to/uv`)\n- `./server.py` should be modified to the actual location of your server script (can use absolute path or path relative to workspace)\n\n```json\n{\n  \"mcpServers\": {\n    \"unsplash\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--with\", \"fastmcp\", \"fastmcp\", \"run\", \"./server.py\"],\n      \"env\": {\n        \"UNSPLASH_ACCESS_KEY\": \"${YOUR_ACCESS_KEY}\"\n      }\n    }\n  }\n}\n```","tools":"## Available Tools\n\n\t\t1. Advanced Image Search: (Search Unsplash's extensive photo library with filters).\n\t\t2. Keyword relevance: (Filter for keyword relevance).\n\t\t3. Color schemes: (Filter for color schemes).\n\t\t4. Orientation options: (Filter for orientation options).\n\t\t5. Custom sorting and pagination: (Filter for custom sorting and pagination).\n\t\t6. Search Photos: (Tool to search photos with query, per_page and orientation parameters).","faq":null,"created_at":"2025-03-18T08:42:50+00:00","updated_at":"2025-03-28T04:37:36+00:00","source_url":"https://model-context-protocol.com/servers/unsplash-image-search-mcp-server-api","related_articles":[]}