Skip to main content
Glama
TheBananaStand

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_access_key

设置 → 包 → 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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides 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 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables searching and downloading photos from Unsplash via the Unsplash API, with support for pagination, orientation filtering, and multiple resolutions.
    87 npm
    1
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    MCP server that enables searching and downloading Unsplash photos and collections.
    4
    MIT