# Unsplash图片搜索服务端
## 基本信息
- Slug: `hellokaton-unsplash-mcp-server`
- Source: modelscope
- Publisher: @hellokaton/unsplash-mcp-server
- Categories: art-and-culture / search
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@hellokaton/unsplash-mcp-server
## 简介
一个轻量级服务器，可实现与Unsplash图像库的无缝集成，使开发人员能够直接从Cursor编辑器中使用各种过滤器搜索高质量照片。
## 安装提示

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

## MCP Server 详情

# Unsplash MCP Server

English | [简体中文](README_zh.md)

> 一个简单的MCP服务器，用于无缝集成Unsplash图片和搜索功能。

[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![smithery badge](https://smithery.ai/badge/@hellokaton/unsplash-mcp-server)](https://smithery.ai/server/@hellokaton/unsplash-mcp-server)

## 📋 概述

Unsplash MCP Server 用于搜索丰富且高质量的图片。非常适合希望将Unsplash功能集成到自己应用程序中的开发者使用。

## ✨ 特性

- **高级图片搜索**：通过以下过滤条件搜索Unsplash庞大的照片库：
  - 关键词相关性
  - 色彩方案
  - 方向选项
  - 自定义排序和分页

## 🔑 获取Unsplash访问密钥

在安装此服务器之前，您需要获取Unsplash API访问密钥：

1. 在[Unsplash](https://unsplash.com/developers)创建一个开发者账户
2. 注册一个新的应用
3. 从应用详情页面获取您的访问密钥
4. 在下面的配置步骤中使用此密钥

更多细节，请参考[官方Unsplash API文档](https://unsplash.com/documentation)。

## 🚀 安装

要通过[Smithery](https://smithery.ai/server/@hellokaton/unsplash-mcp-server)自动为Claude Desktop安装Unsplash图像集成服务器：

### IDE 设置

**Cursor IDE**

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


**Windsurf**

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


**Cline**

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


### 手动安装

```bash
# 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 编辑器集成**

将以下配置添加到您的Cursor编辑器的`settings.json`中：

⚠️ **注意：** 请根据您的实际安装情况调整以下配置：

- 如果`uv`不在您的系统PATH中，请使用绝对路径（例如`/path/to/uv`）
- `./server.py`应修改为您服务器脚本的实际位置（可以使用绝对路径或相对于工作区的路径）

<img src="screenshots/Snipaste_1.png" alt="Cursor 配置截图" />

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


### 在Cursor中使用

<img src="screenshots/Snipaste_2.png" alt="Cursor 中的Unsplash MCP" />

## 🛠️ 可用工具

### 搜索图片

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


## 🔄 其他实现

- Golang: [unsplash-mcp-server](https://github.com/douglarek/unsplash-mcp-server)
- Java: [unsplash-mcp-server](https://github.com/JavaProgrammerLB/unsplash-mcp-server)

## 📄 许可证

[MIT许可证](LICENSE)

## 📬 联系方式

- [Twitter/X](https://x.com/hellokaton)
- [GitHub Issues](https://github.com/hellokaton/unsplash-mcp-server/issues)