Random Number Generator

🚀 Wallpaper MCP Server

Allows MCP clients to generate wallpaper images and set them as the MacOS desktop wallpaper.

🚀 Quick Start

Prerequisites

• MacOS operating system
• Luma Labs API key

Obtain the Luma Labs API Key

Visit Luma Labs Dream Machine API

Installation

git clone git@github.com:shahanneda/wallpaper-mcp.git

Integration with Claude Desktop

To use this server with Claude Desktop, add the following to your Claude Desktop configuration file:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
    "wallpaper": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "lumaai",
        "--with",
        "requests",
        "mcp",
        "run",
        "/path/to/server.py"
      ],
      "env": {
        "LUMAAI_API_KEY": "API_KEY_HERE"
      }
    }
}

Replace /path/to/server.py with the actual path to your server.

Testing with MCP Inspector

Run in the development environment:

 LUMAAI_API_KEY=API_KEY_HERE mcp dev server.py --with lumaai --with requests

✨ Features

Tools

• generate_image

  • Description: Generate an image using Luma Labs AI.
  • Input: prompt (string) - A text description of the image.
  • Output: Returns the generated image.

• generate_wallpaper

  • Description: Generate a wallpaper image and save it to a temporary directory.
  • Input: prompt (string) - A text description of the wallpaper.
  • Output: Returns the path to the generated wallpaper image.

• set_image_from_path

  • Description: Set the wallpaper using an image file from a specific path.
  • Input: image_path (string) - The full path to the image file.
  • Output: A message indicating whether the wallpaper was successfully set.

• generate_and_set_wallpaper

  • Description: Generate a wallpaper from a prompt and set it as your desktop wallpaper.
  • Input: prompt (string) - A text description of the wallpaper.
  • Output: A message indicating whether the wallpaper was successfully generated and set.

Video Demo

📄 License

This MCP server is released under the MIT License.