Unsplash MCP Server Swift

🚀 Unsplash MCP サーバー（unsplash-mcp-server）

このツールは、Unsplash APIとやり取りするためのMCPサーバーです。コマンドラインまたはネットワークインターフェースを通じて呼び出すことができ、言語モデルや他のアプリケーションに対して、スムーズなUnsplash画像の検索と取得機能を提供します。

🚀 クイックスタート

このサーバーは、言語モデルや他のアプリケーションにUnsplash画像の検索と取得機能を提供します。以下の手順に沿ってインストールと設定を行い、すぐに利用を開始できます。

✨ 主な機能

• コマンドラインまたはネットワークインターフェースを通じた呼び出しに対応
• 言語モデルや他のアプリケーションに対するUnsplash画像の検索と取得機能の提供

📦 インストール

依存関係のインストール

• Go 1.20 以上のバージョン
• Unsplash APIアクセスキー

パッケージのインストール

go get github.com/okooo5km/unsplash-mcp-server-go@latest

サーバーの起動

インストールが完了したら、以下のコマンドでサーバーを起動できます。

unsplash-mcp-server --help

📚 ドキュメント

環境変数の設定

settings.jsonに以下の内容を追加します。

{
  "mcpServers": {
    "unsplash": {
      "command": "unsplash-mcp-server",
      "env": {
        "UNSPLASH_API_KEY": "your_unsplash_api_key"
      }
    }
  }
}

パラメータの設定

サーバーは以下のパラメータをサポートしています。

• -h, --help: ヘルプ情報を表示
• -v, --version: バージョン番号を表示
• -t, --transport <string>: 伝送プロトコルを設定（デフォルト：stdio）
  • stdio: 標準入出力モードで、LLMとの直接統合に適しています。
  • sse: Server-Sent Eventsモードで、ネットワーク接続をサポートします。
• -p, --port <int>: SSEモードでのリスニングポート（デフォルト：8080）

💻 使用例

画像検索

{
  "query": "自然风光",
  "per_page": 5,
  "color": "蓝色",
  "orientation": "横版"
}

画像詳細の取得

{
  "photoId": "Dwu85P9SOIk"
}

ランダム画像の取得

{
  "count": 3,
  "query": "咖啡",
  "orientation": "竖版"
}

🔧 技術詳細

開発要件

• Go言語1.20以上のバージョン
• Unsplash APIアクセスキー
• MCP Go SDK 0.19.0 以上のバージョン

システムプロンプトの例

あなたは、以下のシステムプロンプトを使用して、Claudeがunsplash-mcp-serverをより効果的に利用できるようにすることができます。

1. search_photosツールを使用して、任意のテーマの画像を検索します。
2. get_photoを使用して、特定の画像の詳細情報を取得します。
3. random_photoツールを使用して、フィルタ条件に合致するランダムな画像を取得します。
4. ユーザーが画像を要求した場合、これらのツールを使用して関連するUnsplash画像を検索し、URLリンクを添付します。

バージョン履歴

詳細なバージョン履歴については、GitHubのリリースノートを参照してください。

プロジェクトのサポート

このプロジェクトが役に立った場合は、以下の方法でサポートをしていただけると幸いです。

• ⭐️ プロジェクトにスターを付ける

• 🐛 問題や機能提案を提出する

• 🔄 Pull Requestを提出してコードを改善する

• 💝 寄付する：

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は以下の通りです。

MIT License
Copyright (c) 2024, okooo5km
許諾条件は同梱のLICENSEファイルまたは https://opensource.org/licenses/MIT を参照してください。