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"
}

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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.

Tools

search_photos

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

WebPerfect MCP Server
splendasucks
A
security
A
license
A
quality
An intelligent MCP server with a fully automated batch pipeline for web-ready images. Features include noise reduction, auto levels/curves, JPEG artifact removal, 4K resizing, smart sharpening with shadow/highlight enhancement, and advanced WebP conversion.
Last updated -
1
5
JavaScript
MIT License
Weaviate MCP Server
kirill-markin
A
security
A
license
A
quality
A simple MCP server that facilitates website fetching through a configurable server platform using stdio or SSE transport, allowing integration with tools like Cursor for streamlined access.
Last updated -
2
23
Python
MIT License
MCP Image Placeholder Server
husniadil
A
security
A
license
A
quality
This server generates placeholder image URLs from various providers, supporting input validation and integration with desktop applications like Claude and Cursor.
Last updated -
1
6
MIT License
Freepik MCP Server
MCERQUA
-
security
F
license
-
quality
An MCP server implementation that enables users to search, download Freepik resources, and generate images using Mystic AI through natural language requests.
Last updated -
JavaScript

View all related MCP servers

Unsplash MCP Server