Unsplash MCP 服务器
English |简体中文
一个简单的 MCP 服务器，用于无缝 Unsplash 图像集成和搜索功能。
📋 概述
Unsplash MCP 服务器用于搜索丰富、高质量的图片。对于希望将 Unsplash 功能集成到自身应用程序中的开发者来说，它是理想之选。
Related MCP server: Smart Photo Journal MCP Server
✨ 特点
高级图像搜索：使用过滤器搜索 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