javaprogrammerlb_unsplash_mcp_server

javaprogrammerlb_unsplash_mcp_server

by JavaProgrammerLB
A Java-based MCP server for searching and retrieving images from Unsplash.

Unsplash Image Search MCP Server

Overview

The Unsplash Image Search MCP Server is a Java-based implementation that allows users to search for images from Unsplash seamlessly. This project is designed to help developers understand how to create an MCP server using Java while integrating with Unsplash's API for image retrieval.

Features

  • Search Images: Easily search for images from Unsplash using keywords.
  • Learning Resource: A practical example for developers to learn how to build an MCP server in Java.
  • Integration: Direct integration with Unsplash's API for real-time image search.

Showcase

ShowCase

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

  1. Visit Unsplash Developers.
  2. Create an Unsplash application.
  3. Retrieve your access key from the application details page.

4. Configure the 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

Special thanks to the Python Version Unsplash MCP Server for inspiration.

About

This project is a Java implementation of an MCP server for searching images from Unsplash. It serves as both a functional tool and a learning resource for developers.

Resources

License

This project is licensed under the MIT License.

Activity

  • Stars: 5
  • Watchers: 1
  • Forks: 0

Languages

  • Java: 100.0%

Features & Capabilities

Categories
mcp_server model_context_protocol java spring_boot search api_integration unsplash

Implementation Details

View on GitHub

Stats

0 Views
5 GitHub Stars

Repository Info

JavaProgrammerLB Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI