leo-unsplash-mcp

Unsplash-Hintergrundbilder als Leo-Provider-Paket, über MCP.

Leos Hintergrundbild-Generator macht das nicht selbst — er löst einen Provider auf und fragt diesen an. Dieser Server ist einer, erreichbar als ein Paket, das der Hub zur Laufzeit installiert, anstatt eines, für das er neu gebaut werden müsste.

Was es beantwortet

Die Rolle wallpaper in leo_mcp::providers:

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

Ergebnisse kommen als JSON in einem Text-Inhaltsblock zurück, was die Konvention ist, die die Brücke des Hubs liest.

Related MCP server: Unsplash Smart MCP Server

Konfiguration

Leo übergibt diesem Prozess Umgebungsvariablen unter ihren Einstellungsschlüsseln, wörtlich und in Kleinbuchstaben — nur die Schlüssel, die der Deskriptor in entitlements.settings_read deklariert und denen der Eigentümer zugestimmt hat, niemals die gesamte Einstellungstabelle.

Beachten Sie, dass der Schlüssel unsplash_access_key ist, nicht *_api_key — er entspricht dem Einstellungsschlüssel des kompilierten Pakets.

Ohne Konfiguration gibt das Tool isError zurück und nennt dabei die Einstellung. Das ist beabsichtigt: Eine leere Antwort würde Leo als echtes Ergebnis erreichen.

Ausführen

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

Warum reines JavaScript

Dies wird als Git-Tarball ausgeliefert, der an einen Commit-SHA gebunden ist, und npm führt Build-Schritte für eine Tarball-URL nicht zuverlässig aus. Ein TypeScript-Quellbaum würde sich installieren und dann auf dem Rechner einer anderen Person nicht starten, wo es am schwersten zu diagnostizieren ist.

Der Registry-Eintrag muss einen vollständigen 40-Zeichen-Commit-SHA nennen. Ein Tag wirkt ebenso spezifisch, ist es aber nicht — er kann verschoben werden, nachdem der Eintrag überprüft wurde.

Lizenz

MIT