Unsplash MCP Server

English | 简体中文

Unsplash görüntü entegrasyonu ve arama özelliklerinin sorunsuz şekilde kullanılması için basit bir MCP server'ı.

📋 Genel Bakış

Unsplash MCP Server, zengin ve yüksek kaliteli görüntüleri aramak için kullanılır. Unsplash işlevselliğini kendi uygulamalarına entegre etmek isteyen geliştiriciler için idealdir.

✨ Özellikler

• Gelişmiş Görüntü Arama: Unsplash'in geniş fotoğraf kütüphanesinde aşağıdakiler için filtrelerle arama yapın:
  • Anahtar kelime uygunluğu
  • Renk şemaları
  • Oryantasyon seçenekleri
  • Özel sıralama ve sayfalandırma

🔑 Unsplash Access Key Alma

Bu server'ı kurmadan önce, bir Unsplash API Access Key almanız gerekecek:

1. Unsplash adresinde geliştirici hesabı oluşturun
2. Yeni bir uygulama kaydedin
3. Access Key'i uygulama detayları sayfasından alın
4. Bu key'i aşağıdaki konfigürasyon adımlarında kullanın

Daha fazla bilgi için resmi Unsplash API dokümantasyonuna bakın.

🚀 Kurulum

Unsplash Image Integration Server'ı Claude Desktop için Smithery aracılığıyla otomatik olarak kurmak için:

IDE Kurulumu

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-****-****

Manuel Kurulum

# Repository'yi klonlayın
git clone https://github.com/hellokaton/unsplash-mcp-server.git

# Proje dizinine gidin
cd unsplash-mcp-server

# Sanal ortam oluşturun
uv venv

# Bağımlılıkları yükleyin
uv pip install .

Cursor Editor Entegrasyonu

Aşağıdaki konfigürasyonu Cursor editor'ınızın settings.json dosyasına ekleyin:

⚠️ Not: Lütfen aşağıdaki konfigürasyonu gerçek kurulumunuza göre ayarlayın:

• Eğer uv sistem PATH'inizde yoksa, mutlak yolu kullanın (örn. /path/to/uv)
• ./server.py server script'inizin gerçek konumuna değiştirilmelidir (mutlak yol veya workspace'e göre relative yol kullanılabilir)

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

Cursor'da Kullanım

🛠️ Mevcut Araçlar

Fotoğraf Arama

{
  "tool": "search_photos",
  "query": "mountain",
  "per_page": 5,
  "orientation": "landscape"
}

🔄 Diğer Uygulamalar

• Golang: unsplash-mcp-server
• Java: unsplash-mcp-server

📄 Lisans

MIT License

📬 İletişim

• Twitter/X
• GitHub Issues