leo-unsplash-mcp

Fondos de pantalla de Unsplash como paquete de proveedor de Leo, a través de MCP.

El generador de fondos de pantalla de Leo no hace esto por sí mismo — resuelve un proveedor y le pregunta eso. Este servidor es uno, accesible como un paquete que el hub instala en tiempo de ejecución en lugar de uno para el que tenga que reconstruirse.

Lo que responde

El rol wallpaper en leo_mcp::providers:

search_photos({ queries, orientation })
  -> { photos: [{ source_id, download_url, description, photographer }] }

Los resultados vuelven como JSON en un bloque de contenido de texto, que es la convención que lee el puente del hub.

Related MCP server: Unsplash MCP Server

Configuración

Entregadas a este proceso por Leo como variables de entorno bajo sus claves de configuración, tal cual y en minúsculas — solo las claves que el descriptor declara en entitlements.settings_read y a las que el propietario dio su consentimiento, nunca toda la tabla de configuración.

Nota: la clave es unsplash_access_key, no *_api_key — coincide con la clave de configuración del paquete compilado.

Con nada configurado, la herramienta devuelve isError nombrando la configuración. Eso es deliberado: una respuesta vacía llegaría a Leo como un resultado real.

Ejecutarlo

npm install
node index.js   # speaks MCP over stdio
npm test        # checks the response mapping, no network needed

Por qué JavaScript simple

Esto se distribuye como un tarball de git fijado a un SHA de commit, y npm no ejecuta de forma fiable los pasos de compilación para una URL de tarball. Un árbol de código fuente de TypeScript se instalaría y luego fallaría al iniciarse en la máquina de otra persona, donde es más difícil de diagnosticar.

La entrada del registro debe nombrar un SHA de commit completo de 40 caracteres. Una etiqueta se lee como igualmente específica pero no lo es — puede moverse después de que se revise la entrada.

Licencia

MIT