Unsplash MCP Server

# Unsplash MCP 服务器 [English](README.md) | 简体中文 > 一个简单的 MCP 服务器，用于无缝集成 Unsplash 图片搜索功能。 [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://smithery.ai/server/@hellokaton/unsplash-mcp-server) ## 📋 概述 Unsplash MCP 用于搜索丰富的高质量图片。适合希望将 Unsplash 功能集成到自己的应用程序中的开发者。 ## ✨ 特性 - **高级图片搜索**：搜索 Unsplash 庞大的图片库，支持以下筛选条件： - 关键词相关性 - 颜色方案 - 方向选项 - 自定义排序和分页 ## 🔑 获取 Unsplash Access Key 在安装服务器之前，您需要获取 Unsplash API Access Key： 1. 在 [Unsplash](https://unsplash.com/developers) 创建开发者账户 2. 注册一个新应用 3. 从应用详情页获取您的 Access Key 4. 在下面的配置步骤中使用此密钥 更多详情，请参考 [Unsplash 官方 API 文档](https://unsplash.com/documentation)。 ## 🚀 安装 通过 [Smithery](https://smithery.ai/server/@hellokaton/unsplash-mcp-server) 自动为不同 IDE 安装 Unsplash 图片集成服务器： ### IDE 设置 **Cursor IDE** ```bash npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}" ``` **Windsurf** ```bash npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}" ``` **Cline** ```bash npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}" ``` ### 手动安装 ```bash # 克隆代码库 git clone https://github.com/hellokaton/unsplash-mcp-server.git # 进入项目目录 cd unsplash-mcp-server # 创建虚拟环境 uv venv # 安装依赖 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)