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
📄 许可证
📬 联系方式
Related MCP Servers
- Asecurity-licenseAqualityThis server provides tools for uploading images and videos directly to Cloudinary using Claude/Cline, facilitating resource management with customizable options like resource type and public ID.Last updated -89MIT License
- AsecurityAlicenseAqualityThis MCP server aids users in searching and analyzing their photo library by location, labels, and people, offering functionalities like photo analysis and fuzzy matching for enhanced photo management.Last updated -23MIT License
- AsecurityAlicenseAqualityThis server generates placeholder image URLs from various providers, supporting input validation and integration with desktop applications like Claude and Cursor.Last updated -19MIT License
- -security-license-qualityA search service based on multiple image APIs and icon generation capabilities, specifically designed for integration with Cursor MCP service. Supports image search, download, and AI-generated icons.Last updated -10MIT License