Unsplash MCP Server

🚀 Unsplash MCP 服務器

Unsplash MCP 服務器是一個簡單的 MCP 服務器，可用於無縫集成 Unsplash 圖片並具備搜索功能，適合開發者將 Unsplash 功能集成到自己的應用程序中。

English | 繁體中文

🚀 快速開始

🔑 獲取 Unsplash 訪問密鑰

在安裝服務器之前，您需要獲取 Unsplash API 訪問密鑰：

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

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

🚀 安裝

通過 Smithery 自動安裝 Unsplash 圖片集成服務器：

IDE 設置

Cursor IDE

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key 7558c683-****-****

Windsurf

npx -y @smithery/cli@ latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****

Cline

npx -y @smithery/cli@ latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-****

手動安裝

# 克隆倉庫
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 應該修改為實際服務器腳本的位置（可以使用絕對路徑或相對於工作區的路徑）

{
  "mcpServers": {
    "unsplash": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
      }
    }
  }
}

✨ 主要特性

• 高級圖片搜索：通過以下篩選條件搜索 Unsplash 的海量圖庫：
  • 關鍵詞相關性
  • 顏色方案
  • 方向選項
  • 自定義排序和分頁

📚 詳細文檔

🛠️ 可用工具

搜索照片

{
  "tool": "search_photos",
  "query": "your_search_query",
  "page": 1,
  "per_page": 20
}

其他實現

• Unsplash API 文檔
• Python 示例代碼

📄 許可證

MIT 許可證

聯繫方式

• 項目地址：GitHub
• 作者郵箱：[hello@katon.dev]