Unsplash Mcp Server

Search for high-quality images from Unsplash, enabling applications to integrate visual search capabilities. This server also serves as a learning resource for building MCP servers in Java.

Author

Unsplash Mcp Server logo

JavaProgrammerLB

MIT License

Quick Info

GitHub GitHub Stars 7
NPM Weekly Downloads 0
Tools 1
Last Updated 15/7/2025

Tags

javaprogrammerlb java mcp mcp server mcp servers unsplash mcp

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