Hellokaton Unsplash MCP Server

🚀 Unsplash MCP 服務器

一個簡單的MCP服務器，用於無縫集成Unsplash圖片和搜索功能，助力開發者在應用中輕鬆使用Unsplash資源。

English | 簡體中文

🚀 快速開始

Unsplash MCP 服務器用於搜索高質量圖片，非常適合希望在自己的應用中集成 Unsplash 功能的開發者。在使用前，您需要獲取 Unsplash API 訪問密鑰，具體步驟如下：

1. 在 Unsplash 註冊開發者賬戶。
2. 創建一個新的應用。
3. 從應用程序詳情頁面獲取您的訪問密鑰。
4. 在後續的配置步驟中使用此密鑰。

更多細節，請參考官方 Unsplash API 文檔。

✨ 主要特性

• 高級圖片搜索：可搜索 Unsplash 海量圖庫，支持以下過濾器：
  • 關鍵字相關性
  • 顏色方案
  • 橫豎屏方向
  • 自定義排序和分頁

📦 安裝指南

通過 Smithery 自動安裝

通過 Smithery 可自動安裝 Unsplash 圖片集成服務器，不同 IDE 的安裝命令如下：

Cursor IDE

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Windsurf

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Cline

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

手動安裝

# 克隆倉庫
git clone https://github.com/hellokaton/unsplash-mcp-server.git

# 進入項目目錄
cd unsplash-mcp-server

# 創建虛擬環境
uv venv

# 安裝依賴
uv pip install .

Cursor 編輯器集成 將以下配置添加到您的 Cursor 編輯器的 settings.json：

⚠️ 重要提示

請根據實際情況調整以下配置：

• 如果 uv 不在系統 PATH 中，請使用絕對路徑（例如 /path/to/uv）。
• ./server.py 應該修改為您實際的服務器腳本位置（可以使用絕對路徑或相對於工作區的路徑）。

// 配置示例：
{
  "customCss": "",
  "customHtml": "",
  "language": "zh-CN",
  "theme": "vs-dark"
}

🛠️ 工具

安裝依賴

確保安裝了以下工具：

• Python 3.9+
• Node.js（如果需要構建項目）

運行服務器

運行服務器的命令如下：

uv run server.py

訪問 http://localhost:5000 查看結果。

📚 詳細文檔

更多詳細信息，請參考官方文檔。

🔗 其他實現

• Unsplash 官方網站
• GitHub 倉庫

感謝您的使用！如果有任何問題，請隨時聯繫維護人員。