关键词

Unsplash图片搜索AI Agent版权管理图像工具

使用说明

项目简介

Unsplash Smart MCP Server 是一个基于 FastMCP 框架构建的服务器，旨在帮助 AI Agent 无缝集成 Unsplash 图片资源。它提供智能的上下文感知图像搜索、高效的工具调用和自动版权管理，简化了 AI 应用中图片的使用流程。

主要功能点

  • 智能上下文搜索：通过自然语言请求，AI Agent 可以轻松找到符合需求的专业图片，服务器能够理解模糊的请求，并根据上下文智能选择最相关的图像。
  • 单一工具效率：集成了图片搜索、选择、下载和版权管理等功能，通过统一的 'stock_photo' 工具即可完成整个图像工作流程，避免了工具调用碎片化的问题。
  • 自动版权管理：服务器自动处理来自 Unsplash 的图片版权信息，包括本地数据库记录、元数据嵌入和生成版权声明文件，确保开发者合规使用图片。
  • 项目感知的文件组织：能够根据项目类型（如 Next.js、React、Vue 等）智能地组织下载的图片文件，方便项目资源管理。

安装步骤

  1. 克隆仓库

    git clone https://github.com/drumnation/unsplash-smart-mcp-server.git

  2. 进入仓库目录

    cd unsplash-smart-mcp-server

  3. 安装依赖

    npm install

  4. 获取 Unsplash API 密钥 访问 Unsplash 开发者网站 获取 API Access Key。

  5. 配置环境变量 将 Unsplash API 密钥设置为环境变量 'UNSPLASH_ACCESS_KEY'。 可以通过编辑 '.env' 文件或直接在终端中设置。

服务器配置 (MCP 客户端)

在 MCP 客户端（例如 Cursor）的配置文件 'mcp.json' 中，添加以下服务器配置信息以连接 Unsplash Smart MCP Server：

{
  "servers": {
    "unsplash": {
      "command": "npx",
      "args": ["tsx", "src/server.ts"],
      "cwd": "/absolute/path/to/unsplash-smart-mcp-server", // 替换为仓库的绝对路径
      "env": {
        "UNSPLASH_ACCESS_KEY": "your_api_key_here" // 替换为你的 Unsplash API 密钥
      }
    }
  }
}

配置参数说明：

  • 'server name': "unsplash" (服务器名称，在客户端中用于引用此配置)
  • 'command': "npx" (启动服务器的命令，这里使用 npx 来执行 npm 包)
  • 'args': '["tsx", "src/server.ts"]' (命令参数，指定使用 tsx 运行 'src/server.ts' 文件，tsx 用于直接运行 TypeScript 文件)
  • 'cwd': "/absolute/path/to/unsplash-smart-mcp-server" (工作目录，必须设置为你克隆仓库的绝对路径)
  • 'env': '{ "UNSPLASH_ACCESS_KEY": "your_api_key_here" }' (环境变量，用于传递 Unsplash API 密钥给服务器，请替换 'your_api_key_here' 为你实际的 API 密钥)

基本使用方法

配置完成后，在 MCP 客户端中，你可以通过自然语言指令调用 'stock_photo' 工具来搜索和使用 Unsplash 图片。 例如，在 Cursor 编辑器中，你可以向 Claude 提出类似以下的问题：

"Find a professional image for a tech startup landing page hero section"

服务器将根据你的指令，智能地搜索 Unsplash 图库，并返回相关的图片 URL 或自动下载图片到你的项目目录中，同时自动处理版权信息。 你可以通过 'get_attributions' 工具获取已使用图片的所有版权信息。

信息

分类

AI与计算

访问项目