leo-unsplash-mcp

Unsplash の壁紙を Leo プロバイダーパッケージ として、MCP 経由で提供します。

Leo の壁紙ジェネレーターはこれを直接行いません。プロバイダーを解決して、そのプロバイダーに要求します。このサーバーはその1つであり、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 であり、*_api_key ではないことに注意してください。コンパイル済みパッケージの設定キーと一致します。

何も設定されていない場合、ツールは設定を指定した isError を返します。これは意図的です。空の回答は Leo に実際の結果として届くためです。

実行方法

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

なぜ素の JavaScript なのか

これはコミット SHA に固定された git tarball として配布され、npm は tarball URL のビルドステップを確実に実行しません。TypeScript のソースツリーはインストールされた後、他の誰かのマシンで起動に失敗します。そこでの診断が最も困難です。

レジストリエントリは 完全な40文字のコミット SHA を指定する必要があります。タグは同等に具体的に見えますが、そうではありません。エントリがレビューされた後に移動される可能性があるためです。

ライセンス

MIT