关键词

图片搜索Unsplash图片资源LLM工具多媒体

使用说明

项目简介

Unsplash 图片 MCP 服务器是一个实现了 Model Context Protocol (MCP) 协议的后端服务，旨在为大型语言模型 (LLM) 应用提供便捷的 Unsplash 图片资源访问能力。通过集成此服务器，LLM 可以利用其提供的工具，轻松地搜索、获取 Unsplash 上的高质量图片，并将其融入到对话或应用流程中，从而增强 LLM 的多媒体处理和内容创作能力。

主要功能点

  • 强大的图片搜索: 支持关键词、颜色、图片方向等多种条件组合搜索 Unsplash 图片库。
  • 详细图片信息: 能够获取指定 Unsplash 图片的完整信息，包括 EXIF 数据、地理位置和摄影师信息等。
  • 灵活的随机图片: 可以根据多种过滤条件（如主题、用户、内容安全等）获取随机 Unsplash 图片。

安装步骤

本服务器提供两种安装方式：

方式一：下载预编译二进制文件

  1. 访问 GitHub Releases 下载最新版本的 'unsplash-mcp-server' 预编译二进制文件。
  2. 打开终端，使用 'chmod +x /path/to/unsplash-mcp-server' 命令为下载的文件添加执行权限（请将 '/path/to/unsplash-mcp-server' 替换为您的实际文件路径）。
  3. （可选）为了方便使用，可以将该二进制文件移动到系统 PATH 环境变量包含的目录中，例如 '/usr/local/bin/'。

方式二：从源代码构建

  1. 确保您的 macOS 系统已安装 Swift 6.0 或更高版本和 macOS 14.0 或更高版本。
  2. 在终端中使用 'git clone https://github.com/okooo5km/unsplash-mcp-server-swift.git' 命令克隆仓库到本地。
  3. 进入仓库目录 'cd unsplash-mcp-server-swift'。
  4. 根据您的硬件平台选择构建命令：
    • Apple Silicon (arm64) 平台：'swift build -c release --arch arm64 -j $(sysctl -n hw.ncpu)'
    • Intel (x86_64) 平台：'swift build -c release --arch x86_64 -j $(sysctl -n hw.ncpu)'
    • 通用二进制文件 (同时支持 arm64 和 x86_64)：按照 README.md 中的 "Option C: Build Universal Binary" 步骤操作。
  5. 构建完成后，可执行文件位于 '.build/bin' 或 '.build/apple/Products/Release' 或 '.build/x86_64-apple-macosx/release' 目录下。
  6. （可选）将构建好的可执行文件复制到 '/usr/local/bin/' 等目录，以便全局访问。

服务器配置

1. 获取 Unsplash API 密钥

  • 访问 Unsplash Developers Portal 并注册成为开发者。
  • 创建一个新的应用并获取 Access Key (也称为 Client ID)。

2. 配置环境变量

  • 在您的终端或系统环境中设置 'UNSPLASH_ACCESS_KEY' 环境变量，并将您的 Unsplash API 密钥设置为该变量的值。 
    export UNSPLASH_ACCESS_KEY="YOUR_UNSPLASH_API_KEY"  # 将 YOUR_UNSPLASH_API_KEY 替换为您的密钥

3. MCP 客户端配置

您需要在支持 MCP 协议的 LLM 客户端中配置 Unsplash MCP 服务器。以下是一些常见客户端的配置示例：

  • Claude.app:

    {
  "mcpServers": {
    "unsplash": {
      "command": "unsplash-mcp-server" // 服务器启动命令
    }
  }
}

  • Cursor:

    {
  "mcpServers": {
    "unsplash": {
      "command": "unsplash-mcp-server", // 服务器启动命令
      "env": {
        "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}" // 通过环境变量传递 Unsplash API 密钥，需要您在 Cursor 中配置环境变量
      }
    }
  }
}

  • Chatwise: (请参考 Chatwise 客户端的 MCP 服务器配置说明)

注意: 'command' 字段指定了启动 Unsplash MCP 服务器的命令，通常为 'unsplash-mcp-server'（如果已将其添加到 PATH 环境变量中）或其完整路径。'env' 字段用于设置服务器运行所需的环境变量，例如 Unsplash API 密钥。

基本使用方法

  1. 确保已正确安装和配置 Unsplash MCP 服务器，并已启动服务器。
  2. 在您的 MCP 客户端中，您应该能够看到名为 "unsplash" 的服务器已连接。
  3. 在 LLM 对话或应用中，您可以指示 LLM 使用 "unsplash" 服务器提供的工具，例如：
    • 使用 'search_photos' 工具搜索特定主题的图片，例如 "帮我搜索关于猫的图片"。
    • 使用 'get_photo' 工具获取指定 ID 的图片详细信息，例如 "请获取图片 ID 为 'xyz123' 的详细信息"。
    • 使用 'random_photo' 工具获取一张随机图片，例如 "给我一张随机的风景图片"。

具体的工具调用方式和参数请参考仓库 README.md 中 "Available Tools" 部分的详细描述。LLM 客户端会根据您的指示调用相应的工具，并将结果返回给您。

信息

分类

网页与API

访问项目