drio
Open app

Unsplash MCP Server

Source

java version unsplash mcp server

Catalog onlyCatalog onlySTDIO

Overview

The Unsplash MCP Server is a Java-based server that allows users to easily search for pictures from Unsplash, a popular image repository.

To use the Unsplash MCP Server, clone the project from GitHub, build it using Maven, obtain an Unsplash access key, and configure the server with the access key.

  • Easy integration with Unsplash API for image searching. - Written in Java, providing a learning resource for creating MCP servers. - Supports configuration for server commands and environment variables.
  1. Searching for images for web applications.
  2. Learning how to implement a server using Java.
  3. Automating image retrieval for projects.

Add to your AI client

Use these steps to connect Unsplash MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "unsplash-mcp-server-javaprogrammerlb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unsplash-mcp-server-javaprogrammerlb"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "unsplash-mcp-server-javaprogrammerlb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unsplash-mcp-server-javaprogrammerlb"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "unsplash-mcp-server-javaprogrammerlb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unsplash-mcp-server-javaprogrammerlb"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "unsplash-mcp-server-javaprogrammerlb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unsplash-mcp-server-javaprogrammerlb"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "unsplash-mcp-server-javaprogrammerlb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unsplash-mcp-server-javaprogrammerlb"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "unsplash-mcp-server-javaprogrammerlb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unsplash-mcp-server-javaprogrammerlb"
      ]
    }
  }
}

FAQ

How do I get an Unsplash access key?

You can obtain an Unsplash access key by creating an application on the Unsplash developer page.

Is this project suitable for beginners?

Yes! This project is designed to help users learn how to write an MCP server in Java.

What license is the Unsplash MCP Server under?

The project is licensed under the MIT license.

Developer tools
Unsplash MCP Server — MCP Registry