🖼️ Unsplash Smart MCP Server

🖼️ Unsplash Smart MCP Server

产品定位

Unsplash Smart MCP Server 是一个专为AI代理设计的图像搜索和推荐服务，旨在通过智能上下文感知和自动属性管理，简化专业库存照片的获取流程。

核心功能

1. AI代理优化：专为AI代理设计，支持自然语言请求。
2. 上下文感知图像选择：智能解析模糊请求，提供相关图像。
3. 资源优化：采用URL优先方法，节省带宽和存储。
4. 自动属性管理：内置Unsplash服务条款合规性，自动处理图像属性。
5. 项目感知组织：根据项目结构智能组织图像。

适用场景

1. UI开发：快速获取占位图像，保持组件一致性。
2. 文档编写：增强技术文档的视觉效果。
3. 内容创作：为博客、社交媒体等快速找到合适图像。
4. 应用开发：丰富用户体验，如电商网站的产品图像。

工具列表

1. stock_photo：统一处理图像搜索、推荐和下载的整个工作流。
2. get_attributions：生成和管理图像属性数据，支持多种格式输出。

常见问题解答

1. 连接被拒绝：确保服务器在配置的端口上运行。
2. 认证错误：验证Unsplash API密钥是否正确设置。
3. 未找到图像：尝试更广泛的搜索词或检查查询。
4. 下载权限问题：使用urls_only模式和手动下载命令。

使用教程

使用依赖

• Node.js 18.x或更高版本
• Unsplash API访问密钥

安装教程

通过Cursor（推荐）

claude mcp add unsplash https://github.com/drumnation/unsplash-smart-mcp-server.git
claude mcp config set unsplash UNSPLASH_ACCESS_KEY=your_api_key_here

手动安装

git clone https://github.com/drumnation/unsplash-smart-mcp-server.git
cd unsplash-smart-mcp-server
npm install
echo "UNSPLASH_ACCESS_KEY=your_api_key_here" > .env
npm run build
npm start

调试方式

1. 确保服务器运行在配置的端口上。
2. 验证API密钥是否正确设置。
3. 使用自然语言请求测试图像搜索功能。

Find me an image of a mountain landscape

许可证

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