Unsplash MCP Server

Name: Unsplash MCP Server
Author: JavaProgrammerLB

@JavaProgrammerLB

Repository

About Unsplash MCP Server

java version unsplash mcp server

#unsplash #mcp-server #java

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Unsplash MCP Server?

Unsplash MCP Server is an MCP server that enables searching for pictures from Unsplash. It is built with Java and can be used to integrate Unsplash image search into AI applications that support the Model Context Protocol.

How to use Unsplash MCP Server?

Clone the repository, build with Maven (mvn clean package), obtain an Unsplash Access Key from the Unsplash Developer portal, then configure the MCP server in your client’s settings with the java command, JAR path, and the UNSPLASH_ACCESS_KEY environment variable.

Key features of Unsplash MCP Server

Search pictures from Unsplash using natural language queries
Built with Java and Spring AI
Easy to integrate into any MCP-compatible client
Lightweight, no external dependencies beyond Java

Use cases of Unsplash MCP Server

Automatically find and download Unsplash images for documentation
Generate visual content based on user prompts in an AI chat
Enhance AI assistants with real-time image search capabilities

FAQ from Unsplash MCP Server

What do I need to use Unsplash MCP Server?

You need a Java runtime, the built JAR file, and a valid Unsplash Access Key obtained from the Unsplash Developer portal.

Does this server support authentication?

Yes, the server requires the UNSPLASH_ACCESS_KEY environment variable set to your personal Unsplash Access Key.

What transport does this server use?

The server uses the stdio transport (Spring AI MCP stdio mode), as configured with -Dspring.ai.mcp.server.stdio=true.

How do I configure the server in my MCP client?

Add a configuration entry under mcpServers with the command java, the provided arguments, and the environment variable for the access key.

What are the limitations?

The README does not specify any limitations, but the server relies on the Unsplash API quota and requires a network connection.

Comments

More Other MCP servers

Website

FunnyWolf

Adversary simulation and Red teaming platform with AI

5.1K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K