Back to MCP directory
publicPublicdnsLocal runtime

Random Number Generator

Wallpaper MCP是一个允许MCP客户端通过Luma Labs AI生成壁纸并设置为MacOS桌面背景的服务

article

README

🚀 壁纸 MCP 服务器

本项目允许 MCP 客户端生成壁纸图像,并将其设置为 MacOS 桌面的壁纸,为用户带来便捷的壁纸设置体验。

🚀 快速开始

先决条件

  • MacOS 系统
  • Luma Labs API 密钥

获取 Luma Labs API 密钥

访问 Luma Labs Dream Machine API

安装

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

与 Claude Desktop 集成

要将此服务器与 Claude Desktop 一起使用,请在您的 Claude Desktop 配置文件中添加以下内容:

  • 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"
      }
    }
}

/path/to/server.py 替换为您服务器的实际路径。

使用 MCP Inspector 进行测试

在开发环境中运行:

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

✨ 主要特性

工具

  • generate_image

    • 描述:使用 Luma Labs AI 生成图像。
    • 输入prompt (字符串) - 图像的文字描述。
    • 输出:返回生成的图像。
  • generate_wallpaper

    • 描述:生成壁纸图像并将其保存到临时目录中。
    • 输入prompt (字符串) - 壁纸的文字描述。
    • 输出:返回生成的壁纸图像路径。
  • set_image_from_path

    • 描述:从特定路径使用图像文件设置 wallpaper。
    • 输入image_path (字符串) - 图像文件的完整路径。
    • 输出:一条消息,指示是否成功设置了 wallpaper。
  • generate_and_set_wallpaper

    • 描述:从提示生成壁纸并将其设置为您的桌面 wallpaper。
    • 输入prompt (字符串) - 壁纸的文字描述。
    • 输出:一条消息,指示是否成功生成并设置了 wallpaper。

视频演示

视频缩略图

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client