英語 |简体中文

Unsplash画像のシームレスな統合と検索機能を備えたシンプルなMCPサーバーです。

📋 概要

Unsplash MCP Serverは、豊かで高品質な画像の検索に使われます。Unsplash機能を自分のアプリケーションに統合したい開発者に最適です。

✨ 特徴

• 高度な画像検索:Unsplashの豊富な写真ライブラリを検索できるフィルター付き:
• キーワード関連性
• カラースキーム
• 向きのオプション
• カスタムソートとページ付け

🔑 アンスプラッシュアクセスキーの入手中

このサーバーをインストールする前に、Unsplash APIアクセスキーを取得する必要があります:

1. Unsplashで開発者アカウントを作成する
2. 新規申請登録
3. 申請詳細ページからアクセスキーを取得する
4. 以下の設定手順でこのキーを使用します

詳細については、公式のUnsplash APIドキュメントをご参照ください。

🚀 設置

Smithery経由でClaude Desktop用のUnsplash画像統合サーバーを自動的にインストールするには:

IDEセットアップ

カーソルIDE

ウィンドサーフィン

クライン

手動インストール

カーソルエディター統合

カーソルエディターのsettings.jsonに以下の構成を追加します:

Unsplash MCP Server

English | 简体中文

A simple MCP server for seamless Unsplash image integration and search capabilities.

📋 Overview

Unsplash MCP Server is used for searching rich, high-quality images. It’s ideal for developers who want to integrate Unsplash functionality into their own applications.

✨ Features

• Advanced Image Search: Search Unsplash’s extensive photo library with filters for:
  • Keyword relevance
  • Color schemes
  • Orientation options
  • Custom sorting and pagination

🔑 Obtaining Unsplash Access Key

Before installing this server, you’ll need to obtain an Unsplash API Access Key:

1. Create a developer account at Unsplash
2. Register a new application
3. Get your Access Key from the application details page
4. Use this key in the configuration steps below

For more details, refer to the official Unsplash API documentation.

🚀 Installation

To install Unsplash Image Integration Server for Claude Desktop automatically via Smithery:

IDE Setup

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

Manual Installation

# Clone the repository
git clone https://github.com/hellokaton/unsplash-mcp-server.git

# Navigate to project directory
cd unsplash-mcp-server

# Create virtual environment
uv venv

# Install dependencies
uv pip install .

Cursor Editor Integration

Add the following configuration to your Cursor editor’s settings.json:

⚠️ Note: Please adjust the following configuration according to your actual installation:

• If uv is not in your system PATH, use an absolute path (e.g., /path/to/uv)
• ./server.py should be modified to the actual location of your server script (can use absolute path or path relative to workspace)