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 MCP Server

配置

由 Leo 以环境变量的形式传递给此进程，使用其设置键，原样且小写——仅限描述符在 entitlements.settings_read 中声明且所有者同意的键，绝不传递整个设置表。

注意键是 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