Unsplash MCP Server

基本能力

产品定位

Unsplash MCP Server 是一个专门用于与 Unsplash API 交互的服务，提供照片搜索和下载功能。

核心功能

• 提供 MCP 工具与 Unsplash API 交互
• 支持基于查询、分页和方向等参数搜索照片
• 支持下载不同分辨率的照片（raw, full, regular, small）
• 需要配置 Unsplash Access Key 作为环境变量
• 下载的照片保存在工作区的 unsplash/ 目录中

适用场景

• 需要从 Unsplash 获取高质量照片的应用
• 需要批量下载或搜索照片的开发项目
• 需要集成 Unsplash API 的自动化工具

工具列表

• search_photos: 搜索 Unsplash 上的照片
• 输入参数：查询词、页码、每页数量、方向
• 输出：返回搜索结果的 JSON 数据和格式化文本摘要
• download_photo: 下载 Unsplash 照片到工作区的 unsplash/ 文件夹
• 输入参数：照片 ID、分辨率、文件名
• 输出：返回下载成功的消息和文件路径

常见问题解答

• 需要配置 Unsplash Access Key 作为环境变量
• 下载的照片保存在工作区的 unsplash/ 目录中

使用教程

使用依赖

• Node.js (v18+ 推荐)
• Bun (npm install -g bun)
• Unsplash 账户和 API Access Key

安装教程

1. 克隆仓库： bash git clone https://github.com/shariqriazz/upsplash-mcp-server.git cd upsplash-mcp-server
2. 安装依赖： bash bun install
3. 配置环境：
4. 创建 .env 文件并添加 Unsplash Access Key： dotenv UNSPLASH_ACCESS_KEY="YOUR_UNSPLASH_ACCESS_KEY"
5. 构建服务器： bash bun run build

调试方式

• 运行编译后的服务器： bash bun run build/index.js # 或 node build/index.js
• 使用 NPX 运行（如果已发布到 npm）： bash npx -y unsplash-mcp-server

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。