Unsplash MCP Server Swift

🚀 Unsplash MCP 服務端（unsplash-mcp-server）

Unsplash MCP 服務端是一個用於與 Unsplash API 交互的 MCP 服務器工具，支持通過命令行或網絡接口調用。它能為語言模型或其他應用程序提供無縫的 Unsplash 圖片搜索和獲取功能，讓圖片資源的獲取更加便捷。

🚀 快速開始

你可以按照下面的步驟快速啟動 Unsplash MCP 服務端：

1. 確保安裝了 Go 1.20 或更高版本以及 Unsplash API 訪問密鑰。
2. 安裝軟件包：

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

3. 啟動服務端：

unsplash-mcp-server --help

✨ 主要特性

• 多方式調用：支持通過命令行或網絡接口調用，使用靈活。
• 無縫集成：為語言模型或其他應用程序提供無縫的 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）

開發要求

• 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 發行說明。

支持項目

如果覺得這個項目對你有幫助，請通過以下方式支持：

• ⭐️ 給項目點個 Star

• 🐛 提交問題或功能建議

• 🔄 提交 Pull Request 改進代碼

• 💝 捐助：

💻 使用示例

基礎用法

圖片搜索

{
  "query": "自然風光",
  "per_page": 5,
  "color": "藍色",
  "orientation": "橫版"
}

獲取圖片詳情

{
  "photoId": "Dwu85P9SOIk"
}

隨機圖片獲取

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

📄 許可證

本項目基於 MIT 許可證開源，具體內容如下：

MIT License
版權所有 (c) 2024, okooo5km
許可條款見隨附的LICENSE文件或 https://opensource.org/licenses/MIT