remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides advanced image search capabilities for Unsplash's photo library, allowing filtering by keyword relevance, color schemes, orientation options, with custom sorting and pagination.

Unsplash MCP 服务器

English |简体中文

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

📋 概述

Unsplash MCP 服务器用于搜索丰富、高质量的图片。对于希望将 Unsplash 功能集成到自身应用程序中的开发者来说，它是理想之选。

✨ 特点

高级图像搜索：使用过滤器搜索 Unsplash 的海量照片库：
- 关键词相关性
- 配色方案
- 方向选项
- 自定义排序和分页

🔑 获取 Unsplash 访问密钥

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

在Unsplash创建开发者帐户
注册新应用程序
从应用程序详细信息页面获取访问密钥
在下面的配置步骤中使用此密钥

更多详细信息，请参阅官方 Unsplash API 文档。

🚀 安装

要通过Smithery自动为 Claude Desktop 安装 Unsplash 图像集成服务器：

IDE 设置

游标 IDE

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

风帆冲浪

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

克莱恩

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

手动安装

# 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 编辑器的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}"
      }
    }
  }
}

在游标中使用

🛠️ 可用工具

搜索照片

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

🔄 其他实现

Golang： unsplash-mcp-服务器
Java： unsplash-mcp-server

📄 许可证

MIT 许可证

📬 联系方式

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

search_photos

轻量级服务器，可与 Unsplash 的图片库无缝集成，让开发者可以直接从 Cursor 编辑器中搜索具有各种滤镜的高质量照片。

Related Resources

Reddit Discussion about this server

Unsplash MCP Server