Unsplash MCP Server Go

🚀 Unsplash MCP サーバー

このサーバーは、Unsplash API とのインタラクションを行う軽量なオープンソースのリレーサーバーで、エディタや他の言語モデル向けに設計されています。

✨ 主な機能

• MCP プロトコルを通じた言語モデルとの統合をサポート
• 写真の検索、写真の詳細情報の取得、ランダムな写真の取得など、様々な機能を提供
• 高い柔軟性で、カスタムフィルタ条件とページングブラウジングをサポート
• 詳細な使用ドキュメントと技術サポートを提供

📦 インストール

事前構築済みのバイナリファイルを使用する

使用しているオペレーティングシステムに合ったバージョンを選択してください。

ソースコードからビルドする

git clone https://github.com/okooo5km/unsplash-mcp-server.git
cd unsplash-mcp-server
go build .

📚 ドキュメント

必要な環境変数

• UNSPLASH_ACCESS_KEY：認証に使用する Unsplash API のアクセスキーです。Unsplash 開発ドキュメント を参照して取得してください。

サービスの設定

config.json という名前のファイルを作成し、以下の内容を記述します。

{
  "transport": "stdio",
  "port": 8080,
  "api_key": "your_unsplash_api_key_here"
}

使用シーン

• エディタへの統合：Cursor、VS Code などのエディタに写真検索機能を提供します。
• AI チャットボット：チャット体験を向上させ、画像リンクの挿入をサポートします。
• 個人プロジェクト：Unsplash の写真検索機能を迅速に追加できます。

💻 使用例

基本的な使用法

写真を検索する

{
  "query": "mountain landscape",
  "per_page": 5,
  "color": "blue",
  "orientation": "landscape"
}

写真の詳細情報を取得する

{
  "photoId": "Dwu85P9SOIk"
}

ランダムに写真を取得する

{
  "count": 3,
  "query": "coffee",
  "orientation": "portrait"
}

高度な使用法

コマンドライン引数

以下のコマンドラインオプションをサポートしています。

• -h, --help：サーバーのヘルプ情報を表示します。
• -v, --version：サーバーのバージョン番号を表示します。
• -t, --transport <string>：トランスポートタイプを設定します（デフォルト値："stdio"）。
  • stdio：言語モデルと直接統合するための標準入出力モード。
  • sse：HTTP ベースの Server-Sent Events モード。
• -p, --port <int>：SSE モードのリスニングポートを指定します（デフォルト値：8080）。

設定例

Cursor での設定

Cursor エディタの settings.json に以下を追加します。

{
  "mcpServers": {
    "unsplash": {
      "command": "unsplash-mcp-server",
      "env": {
        "UNSPLASH_ACCESS_KEY": "your_access_key_here"
      }
    }
  }
}

Chatwise での設定

⚠️ 重要提示

Chatwise で環境変数を追加する際には、値を引用符で囲まないでください（#1 の問題を修正）。

開発要件

• Go 1.20 以上
• Unsplash API のアクセスキー
• MCP Go SDK 0.19.0 以上

プロジェクトのサポート

このプロジェクトが役に立った場合は、開発をサポートすることを検討してください。

• GitHub でこのプロジェクトにスターを付ける
• 問題トラッカーでエラーを報告したり、機能提案をする
• コードを改善するためにプルリクエストを送信する
• プロジェクトの発展に貢献する

特別な感謝

📄 ライセンス

unsplash-mcp-server-go は MIT ライセンスの下で公開されています。これにより、このソフトウェアを自由に使用、変更、配布することができますが、著作権表示とライセンス表示を保持する必要があります。