What is Wallpaper Mcp

wallpaper-mcp is a server that allows users to generate and set wallpaper images on MacOS using AI technology from Luma Labs.

Use cases

Use cases include personalizing desktop backgrounds, creating unique visual environments for workspaces, and enhancing aesthetic appeal with custom wallpapers generated from user-defined prompts.

How to use

To use wallpaper-mcp, clone the repository, obtain a Luma Labs API key, and follow the integration instructions for your application. You can generate images and set them as your desktop wallpaper using the provided tools.

Key features

Key features include generating images with Luma Labs AI, saving wallpapers to a temporary directory, setting wallpapers from specific image paths, and generating and setting wallpapers directly from prompts.

Where to use

wallpaper-mcp is primarily used in desktop environments on MacOS, particularly for users who want to customize their wallpaper with AI-generated images.

Wallpaper MCP

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

Features

Tools

• generate_image

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

• generate_wallpaper

  • Description: Generate a wallpaper image and save it to a temporary directory.
  • Input: prompt (string) - Text description of the wallpaper to generate.
  • 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) - Full path to the image file to use as wallpaper.
  • Output: A message indicating whether the wallpaper was set successfully.

• generate_and_set_wallpaper

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

Video Demo

https://www.youtube.com/watch?v=S1MA3t_gMq8

Getting Started

Prerequisites

• macOS
• Luma Labs API key

Getting a Luma Labs API Key

Visit Luma Labs Dream Machine API

Installation

git clone [email protected]: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 absolute path to your server.py file.

Testing with MCP Inspector

To run in development:

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

License

This MCP server is licensed under the MIT License.