MCP server for setting desktop wallpaper across Windows, macOS and Linux
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"wallpaper-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Wallpaper MCP Server [](https://badge.fury.io/py/wallpaper-mcp) [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) A cross-platform MCP (Model Context Protocol) server for setting desktop wallpapers on Windows, macOS, and Linux. 一个跨平台的 MCP 服务器，用于在 Windows、macOS 和 Linux 上设置桌面壁纸。 ## Features / 功能特性 - 🖼️ **Set wallpaper from URL** - Download and set wallpaper from any image URL - 📁 **Set wallpaper from local file** - Use local images as wallpaper - 📱 **Get screen resolution** - Automatically detect current screen resolution - 🎨 **Smart image processing** - Auto-resize and crop images to fit screen perfectly - 🌍 **Cross-platform support** - Works on Windows, macOS, and Linux ## Installation / 安装 ### From PyPI ```bash pip install wallpaper-mcp ``` ### From Source / 从源码安装 ```bash git clone https://github.com/mcpcn/wallpaper-mcp cd wallpaper-mcp pip install -e . ``` ### Using uv ```bash uv pip install wallpaper-mcp ``` ## Usage / 使用方法 ### With Claude Desktop Add to your Claude Desktop configuration: **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "wallpaper": { "command": "wallpaper-mcp" } } } ``` Or if using `uv`: ```json { "mcpServers": { "wallpaper": { "command": "uv", "args": ["--directory", "/path/to/wallpaper-mcp", "run", "wallpaper-mcp"] } } } ``` ## Available Tools / 可用工具 ### 1. set_wallpaper_from_url Set desktop wallpaper from an image URL. **Parameters:** - `url` (required): Image URL to download and set as wallpaper - `resolution` (optional): Target resolution as `{width, height}` object **Example:** ``` Set this aurora image as my wallpaper: https://example.com…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.