Unsplash

by javaprogrammerlb

7 stars

Not rated

GitHub

About

Integrates with Unsplash's photo library to enable image search and retrieval with customizable parameters including search terms, pagination, ordering, color filtering, and orientation preferences.

Details

Author: javaprogrammerlb
Repository: JavaProgrammerLB/unsplash-mcp-server
GitHub stars: 7
License: MIT License
Categories: Search, Media, Other, Developer Tools, Design, AI, Community, Communication, API, Infrastructure, Frontend
Tags: #content-creation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Unsplash

Command (node, npx, python, etc.) java
Arguments
- Argument 1 -Dspring.ai.mcp.server.stdio=true
- Argument 2 -Dspring.main.web-application-type=none
- Argument 3 -Dlogging.pattern.console=
- Argument 4 -jar
- Argument 5 /ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar
Environment
- UNSPLASH_ACCESS_KEY $${YOUR UNSPLASH ACCESS KEY}
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

JSON

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "unsplash": {
            "env": {
                "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
            },
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-Dspring.main.web-application-type=none",
                "-Dlogging.pattern.console=",
                "-jar",
                "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
            ],
            "command": "java"
        }
    }
}

Linux

{
    "env": {
        "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
    },
    "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dlogging.pattern.console=",
        "-jar",
        "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
    ],
    "command": "java"
}

Macos

{
    "env": {
        "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
    },
    "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dlogging.pattern.console=",
        "-jar",
        "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
    ],
    "command": "java"
}

Windows

{
    "env": {
        "UNSPLASH_ACCESS_KEY": "$${YOUR UNSPLASH ACCESS KEY}"
    },
    "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dlogging.pattern.console=",
        "-jar",
        "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar"
    ],
    "command": "java"
}

- With this mcp server, you can easily search picture fromunsplash
- With this project, you can easily learn how to write MCP Server with JAVA

search two house picture from unsplashand write to the document

git clone https://github.com/JavaProgrammerLB/unsplash-mcp-server.git

cd unsplash-mcp-server mvn clean package

- visit unsplash
- create an unsplash application
- find out the access key in unsplash application detail page

{ "mcpServers": { "unsplash": { "command": "java", "args": [ "-Dspring.ai.mcp.server.stdio=true", "-Dspring.main.web-application-type=none", "-Dlogging.pattern.console=", "-jar", "/ABSOLUTE/PATH/target/unsplash-mcp-server-1.0.jar" ], "env": { "UNSPLASH_ACCESS_KEY": "${YOUR UNSPLASH ACCESS KEY}" } } } }

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Query Erick Wendel's contributions, including talks, blog posts, and videos, using natural language.

Search and discover audio content from Freesound.org for video editing and content creation.

Search and retrieve royalty-free images and videos using the Pixabay API.

Search, view details, and download 3D models from the Sketchfab platform.

MCP server for AI music catalog — search, stream, and browse 1M+ AI-generated tracks

MCP server for the Pexels API — photo search, video search, and curated content

An MCP server for accessing the Unsplash API to search for and retrieve photos.

Semantic search over 9 free-license stock photo sources. Hosted remote server with OAuth — no API key to paste.

Official Tavily MCP server for AI search and content extraction, giving MCP clients web search, crawl, and extract tools.

AI-powered news intelligence — 21 tools for personalized monitoring, briefings, and semantic search

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Unsplash

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

Claude Desktop / Cursor

Linux

Macos

Windows

Install

About

Details

Jump to

Setting up with Highlight

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Maps

Google Drive