Unsplash MCP Server Go

🚀 Unsplash MCP 服務器

Unsplash MCP 服務器是一個輕量級的開源中繼服務器，專為編輯器和其他語言模型設計，可與 Unsplash API 進行交互，為各類應用提供便捷的照片搜索與獲取功能。

🚀 快速開始

在使用 Unsplash MCP 服務器前，你需要先完成安裝和配置。安裝方式有使用預構建二進制文件和從源代碼構建兩種，配置則需設置必要的環境變量和服務配置文件。

✨ 主要特性

• 支持通過 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 照片搜索功能。

命令行參數

支持以下命令行選項：

• -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 或更高版本。

💻 使用示例

基礎用法

搜索照片

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

獲取照片詳細信息

{
  "photoId": "Dwu85P9SOIk"
}

隨機獲取照片

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

📄 許可證

unsplash-mcp-server-go 根據 MIT 許可證發佈。這意味著你可以自由地使用、修改和分發此軟件，同時保留版權聲明和許可聲明。

🌟 支持項目

如果你覺得這個項目對你有幫助，請考慮支持它的開發：

• 在 GitHub 上為該項目點星。
• 在問題跟蹤器中報告錯誤或提出功能建議。
• 提交拉取請求以幫助改進代碼。
• 貢獻到項目的發展。

特別鳴謝