{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_x2qsjp89np34","handle":"wallpaper-mcp","url":"https://wellknown.network/agents/wallpaper-mcp","links":{"self":"https://wellknown.network/agents/wallpaper-mcp/record.json","html":"https://wellknown.network/agents/wallpaper-mcp","markdown":"https://wellknown.network/agents/wallpaper-mcp/record.md","api":"https://wellknown.network/api/v1/agents/wallpaper-mcp","status":"https://wellknown.network/api/v1/agents/wallpaper-mcp/status","claim":"https://wellknown.network/agents/wallpaper-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/wallpaper-mcp/claim.json","badge":"https://wellknown.network/agents/wallpaper-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:wallpaper-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"wallpaper-mcp","summary":"MCP server for setting desktop wallpaper across Windows, macOS and Linux","description":"# Wallpaper MCP Server\n\n[![PyPI version](https://badge.fury.io/py/wallpaper-mcp.svg)](https://badge.fury.io/py/wallpaper-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n\nA cross-platform MCP (Model Context Protocol) server for setting desktop wallpapers on Windows, macOS, and Linux.\n\n一个跨平台的 MCP 服务器，用于在 Windows、macOS 和 Linux 上设置桌面壁纸。\n\n## Features / 功能特性\n\n- 🖼️ **Set wallpaper from URL** - Download and set wallpaper from any image URL\n- 📁 **Set wallpaper from local file** - Use local images as wallpaper\n- 📱 **Get screen resolution** - Automatically detect current screen resolution\n- 🎨 **Smart image processing** - Auto-resize and crop images to fit screen perfectly\n- 🌍 **Cross-platform support** - Works on Windows, macOS, and Linux\n\n## Installation / 安装\n\n### From PyPI\n\n```bash\npip install wallpaper-mcp\n```\n\n### From Source / 从源码安装\n\n```bash\ngit clone https://github.com/mcpcn/wallpaper-mcp\ncd wallpaper-mcp\npip install -e .\n```\n\n### Using uv\n\n```bash\nuv pip install wallpaper-mcp\n```\n\n## Usage / 使用方法\n\n### With Claude Desktop\n\nAdd to your Claude Desktop configuration:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"wallpaper\": {\n      \"command\": \"wallpaper-mcp\"\n    }\n  }\n}\n```\n\nOr if using `uv`:\n\n```json\n{\n  \"mcpServers\": {\n    \"wallpaper\": {\n      \"command\": \"uv\",\n      \"args\": [\"--directory\", \"/path/to/wallpaper-mcp\", \"run\", \"wallpaper-mcp\"]\n    }\n  }\n}\n```\n\n## Available Tools / 可用工具\n\n### 1. set_wallpaper_from_url\nSet desktop wallpaper from an image URL.\n\n**Parameters:**\n- `url` (required): Image URL to download and set as wallpaper\n- `resolution` (optional): Target resolution as `{width, height}` object\n\n**Example:**\n```\nSet this aurora image as my wallpaper:\nhttps://example.com…","publisher":null,"homepage":"https://github.com/mcpcn/wallpaper-mcp#readme","repository":"https://github.com/mcpcn/wallpaper-mcp/issues","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["cross-platform","desktop","linux","macos","mcp","wallpaper","windows"],"pricing":null,"endpoints":[{"url":"pypi:wallpaper-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"infra.desktop","name":"Desktop Control","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"wallpaper-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:20.745Z","publishedAt":"2025-12-04T08:46:36.485386Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"wallpaper-mcp","url":"https://pypi.org/project/wallpaper-mcp/","firstSeenAt":"2026-09-10T15:24:05.399Z","fetchedAt":"2026-09-10T15:24:05.399Z","normalizedAt":"2026-09-10T15:24:05.399Z"}]},"firstSeenAt":"2026-09-10T15:24:05.399Z","updatedAt":"2026-09-10T15:25:20.745Z"}