Happy slice of mcp pizzaMCP.pizza

unsplash-mcp-server

MCP.Pizza Chef: JavaProgrammerLB

The Unsplash MCP Server is a Java implementation that enables MCP clients to search and retrieve high-quality images from Unsplash. It provides a simple interface to query Unsplash's vast photo library and integrate image search results into MCP workflows. This server is ideal for developers looking to incorporate real-time image search capabilities into their applications or learn how to build MCP servers using Java.

Use This MCP server To

Search and retrieve high-quality images from Unsplash Integrate Unsplash image search into MCP workflows Automate image insertion into documents or projects Learn MCP server development with Java Fetch specific themed images (e.g., houses) for content creation Enable real-time image lookup in AI-enhanced applications

README

Unsplash MCP Server

  • With this mcp server, you can easily search picture from unsplash
  • With this project, you can easily learn how to write MCP Server with JAVA

search two house picture from unsplash and write to the document

Feature

ShowCase

How to use

  1. Clone this project
git clone https://github.com/JavaProgrammerLB/unsplash-mcp-server.git
  1. Build
cd unsplash-mcp-server
mvn clean package
  1. Get Unsplash Access Key
  • visit unsplash
  • create an unsplash application
  • find out the access key in unsplash application detail page
  1. Config MCP Server
{
  "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}"
      }
    }
  }
}

Thanks

unsplash-mcp-server FAQ

How do I configure the Unsplash MCP Server with my access key?
Obtain an access key by creating an application on Unsplash developers portal, then configure the server environment with this key as per the README instructions.
What programming language is the Unsplash MCP Server built with?
It is built using Java, making it suitable for Java developers and JVM environments.
Can I use this MCP server to search for any type of image on Unsplash?
Yes, you can search for any images available on Unsplash by specifying relevant keywords in your queries.
How do I run the Unsplash MCP Server after cloning the repository?
Build the project using Maven, then run the server with the provided Java command and arguments as detailed in the README.
Is this MCP server compatible with multiple LLM providers?
Yes, it is provider-agnostic and can work with models like OpenAI, Claude, and Gemini.
Does the server support real-time image search during model interactions?
Yes, it enables real-time querying of Unsplash images to enhance model responses with visual content.
Where can I find example usage or showcase of this MCP server?
The GitHub repository includes a showcase image and example commands demonstrating image search and document writing.