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 许可证发布。
扫码联系在线客服