Wallpaper MCP
2025.03.05
2
Python壁纸生成桌面美化娱乐功能
Wallpaper MCP 是一个允许 MCP 客户端生成壁纸图像并将其设置为 MacOS 桌面壁纸的服务。它利用 Luma Labs AI 技术，根据用户提供的文本描述生成图像，并支持将生成的图像直接设置为桌面壁纸。
View on GitHub
Overview
基本能力
产品定位
Wallpaper MCP 是一个专注于壁纸生成和设置的 MCP 服务，旨在为用户提供个性化的桌面壁纸体验。
核心功能
- 图像生成：使用 Luma Labs AI 根据文本描述生成图像。
- 壁纸生成：生成壁纸图像并保存到临时目录。
- 壁纸设置：从指定路径设置图像为桌面壁纸。
- 一键生成并设置壁纸：根据文本描述生成壁纸并直接设置为桌面壁纸。
适用场景
- 用户希望根据个人喜好生成独特的桌面壁纸。
- 开发者希望集成壁纸生成功能到自己的应用中。
- 需要快速更换桌面壁纸的场景。
工具列表
- generate_image：使用 Luma Labs AI 生成图像。
- generate_wallpaper：生成壁纸图像并保存到临时目录。
- set_image_from_path：从指定路径设置图像为桌面壁纸。
- generate_and_set_wallpaper：生成壁纸并直接设置为桌面壁纸。
常见问题解答
- 如何获取 Luma Labs API Key：访问 Luma Labs Dream Machine API 获取。
- 如何集成到 Claude Desktop：在配置文件中添加相应的命令和环境变量。
使用教程
使用依赖
- macOS 操作系统
- Luma Labs API Key
安装教程
git clone [email protected]:shahanneda/wallpaper-mcp.git
集成到 Claude Desktop
在 Claude Desktop 配置文件中添加以下内容：
{
"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"
}
}
}
调试方式
LUMAAI_API_KEY=API_KEY_HERE mcp dev server.py --with lumaai --with requests