leo-unsplash-mcp
leo-unsplash-mcp
将 Unsplash 壁纸作为 Leo 提供方包,通过 MCP 提供。
Leo 的壁纸生成器本身不直接完成这件事——它会解析一个提供方并请求该提供方。这个 服务器就是这样一个提供方,以包的形式被 hub 在运行时安装,而不是需要为它重新构建。
它回答什么
leo_mcp::providers 中的 wallpaper 角色:
search_photos({ queries, orientation })
-> { photos: [{ source_id, download_url, description, photographer }] }结果以 JSON 形式放在文本内容块中返回,这正是 hub 的桥接层读取的约定格式。
Related MCP server: Unsplash Smart MCP Server
配置
由 Leo 以环境变量的形式传递给此进程,使用其设置键,原样且小写——仅限描述符在
entitlements.settings_read 中声明且所有者同意的键,绝不传递整个设置表。
环境变量 | 来源 |
| 设置 → 包 → Unsplash |
注意键是 unsplash_access_key,而不是 *_api_key——它与编译后包的设置键一致。
未配置任何内容时,工具会返回 isError 并指明该设置项。这是有意为之:空答案会作为
真实结果到达 Leo。
运行它
npm install
node index.js # speaks MCP over stdio
npm test # checks the response mapping, no network needed为什么用纯 JavaScript
此包以 git tarball 形式发布并固定到某个提交 SHA,而 npm 对 tarball URL 不能可靠地 执行构建步骤。TypeScript 源码树可以正常安装,但会在别人的机器上启动失败,而那正是 最难排查问题的地方。
注册条目必须指定完整的 40 字符提交 SHA。标签看起来同样具体,但实际上不是—— 标签可以在条目被审查后移动。
许可证
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
AI-powered image processing via GPU. Remove backgrounds and upscale images (2x/4x) directly from any MCP client. OAuth 2.1 authenticated, returns processed images inline with download links. Free credits on signup at maskr.io.
Search over 1.85 million captioned images using text, a reference image, or both. Upload a JPEG, PNG, or WebP image as base64, or provide a public HTTPS image URL. Find similar images from a Lightdrift asset ID and retrieve hosted file URLs, source licenses, and attribution. Connect with OAuth or an API key. Searches cost $0.005 ($5 per 1,000); image details are free. Setup: https://docs.lightdrift.ai/guides/images-mcp
Wikipedia MCP — wraps Wikipedia REST API (free, no auth)
Capture photos remotely from mobile devices via S3-backed upload URLs
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceProvides access to the Unsplash API, enabling AI assistants to search and retrieve high-quality photos, browse collections, view photographer profiles, and get photo statistics with advanced filtering options.87 npmMIT
- AlicenseNot gradedqualityFmaintenanceEnables AI agents to search, recommend, and deliver professional stock photos from Unsplash with intelligent context awareness and automatic attribution management.19 npm63MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and downloading photos from Unsplash via the Unsplash API, with support for pagination, orientation filtering, and multiple resolutions.87 npm1MIT
- AlicenseAqualityCmaintenanceMCP server that enables searching and downloading Unsplash photos and collections.4MIT