MCP HubMCP Hub
JavaProgrammerLB

unsplash-mcp-server

by: JavaProgrammerLB

java version unsplash mcp server

5created 20/03/2025
Visit
Java
Unsplash

📌Overview

Purpose: This framework aims to simplify the process of searching for pictures from Unsplash using a custom MCP server built in Java.

Overview: The Unsplash MCP Server provides an efficient way to search for images from Unsplash and serves as a practical educational tool for developers looking to learn how to implement a MCP server in Java.

Key Features:

  • Image Search Functionality: Enables users to easily find and retrieve images from Unsplash, streamlining the image search process for various applications.

  • Java Implementation: Offers a hands-on example of how to build an MCP server using Java, fostering learning and development skills for aspiring programmers.

Unsplash MCP Server

With this MCP server, you can easily search for pictures from Unsplash and learn how to write an MCP Server with Java.

Features

  • Search for images and write results to a document.

How to Use

  1. Clone the project:

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

  2. Build the project:

    cd unsplash-mcp-server
mvn clean package

  3. Get Unsplash Access Key:

    • Visit Unsplash Developers
    • Create an Unsplash application
    • Obtain your access key from the application detail page.

  4. Configure 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}"
      }
    }
  }
}

Acknowledgements