返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端