Unsplash图片管理服务

UnSplashX是一个基于Unsplash API的模型上下文协议(MCP)服务器,用于搜索、下载和插入高质量图片到本地项目,同时自动添加摄影师署名。

  • by danywalls
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 danywalls/unsplashx

使用说明

UnSplashX

UnSplashX 它是用于Unsplash API的模型上下文协议(MCP)服务器。使用它可以查找、下载高质量图像,并将其直接插入到您的本地项目中。专为开发人员和AI代理(例如Claude、Cursor)而构建。

我为什么建造这个

我厌倦了人工智能生成的图像。我希望有一种快速的方法在我的项目中使用真实的摄影,最重要的是,确保真实的摄影师得到他们应得的赞誉。这就是我建造的原因 UnsplashX.

使用此MCP服务器,您的AI代理可以搜索、下载Unsplash图像并将其直接插入到您的文件中,同时始终遵守强制归因。

特性

  • 搜索:通过查询、方向和颜色发现照片。
  • 汽车信贷:在Markdown/HTML中注入强制摄影师归因。
  • 下载跟踪:每次下载都需要Unsplash API跟踪触发器(GET /photos/:id/download).
  • CDN大小调整:通过内置参数优化URL(w, fit等等)。

设置

1.获取访问密钥

在以下位置创建应用程序 Unsplash开发者 获取您的访问密钥。

2.配置客户端(例如Claude Desktop)

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "unsplash": {
      "command": "npx",
      "args": ["-y", "unsplashx", "YOUR_ACCESS_KEY_HERE"]
    }
  }
}

工具

  • search_photos:使用过滤器搜索图像。
  • insert_to_page:添加图像+归属到本地文件(MD/HTML)。支持 width, height,以及 quality 参数。
  • download_to_project:将文件保存到本地目录。支持 width, height,以及 quality 参数。
  • get_photo:获取照片ID的技术元数据。

示例

为您的项目自动化图像工作流程。问代理人: *“找到一张山景照片并将其插入post.md”*MCP处理搜索、跟踪和归因。

许可证

麻省理工学院