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
Search photos and video moments by visual meaning, people, dates, and folders across local libraries, Apple Photos, and OneDrive. Manage collections, groups, favorites, people, and duplicate review. Synced metadata remains searchable while the desktop is offline; local and Apple Photos media access needs the owning device online with remote access enabled. OneDrive media can be accessed directly from the cloud. OAuth or Bearer API keys. Paid Cloud Access required; hosted visual search uses prepaid credits. Text-in-image search is semantic matching, not guaranteed exact OCR. Setup: https://organizewith.ai/en/guides/connect-ai-assistants
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, preview, and measure Umbra open SAR from any MCP client. Umbra ships no search API.
Browse photo prints, estimate delivery prices, prepare uploads and track orders with scoped OAuth.
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.83 npmMIT
- AlicenseNot gradedqualityFmaintenanceEnables AI agents to search, recommend, and deliver professional stock photos from Unsplash with intelligent context awareness and automatic attribution management.9 npm64MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and downloading photos from Unsplash via the Unsplash API, with support for pagination, orientation filtering, and multiple resolutions.83 npm1MIT
- AlicenseAqualityDmaintenanceMCP server that enables searching and downloading Unsplash photos and collections.4MIT