Unsplash

Provides an MCP bridge to search Unsplash images using a Java-based server.

other

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "javaprogrammerlb-unsplash-mcp-server": {
      "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}"
      }
    }
  }
}

You can run a Java-based MCP Server that lets you search Unsplash images through an MCP client. It exposes a simple endpoint for querying Unsplash and includes the necessary environment key to securely access Unsplash data, making it easy to build automation or tooling around image search.

How to use

Start the Unsplash MCP Server and connect with your MCP client to perform image searches. The server runs locally via Java and reads an Unsplash access key from your environment. Supply your key when you launch the server, and your client can request image search results from Unsplash through the MCP bridge.

How to install

Prerequisites you need before installing: Java Runtime Environment (JRE) or JDK, and Maven for building the project.

Clone the project repository to your machine.

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

Build the project to generate the runnable JAR.

cd unsplash-mcp-server
mvn clean package

Obtain an Unsplash Access Key. Create an Unsplash application and copy the access key from the application details page.
Create the MCP Server configuration. The configuration specifies the Java runtime, JVM options, and the path to the generated JAR, along with your Unsplash access key.

{
  "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}"
      }
    }
  }
}

Available tools

UnsplashSearch

Enables MCP clients to perform image searches against Unsplash and retrieve results via the MCP bridge.

Built by

VeilStrat

AI signals for GTM teams