🚀 Unsplash MCP 服务器

Unsplash MCP 服务器是一个轻量级的开源中继服务器，专为编辑器和其他语言模型设计，可与 Unsplash API 进行交互，为各类应用提供便捷的照片搜索与获取功能。

🚀 快速开始

在使用 Unsplash MCP 服务器前，你需要先完成安装和配置。安装方式有使用预构建二进制文件和从源代码构建两种，配置则需设置必要的环境变量和服务配置文件。

✨ 主要特性

• 支持通过 MCP 协议与语言模型集成，方便各类应用调用。
• 提供多种功能，涵盖搜索照片、获取照片详细信息和随机照片等，满足不同场景需求。
• 灵活性高，支持自定义过滤条件和分页浏览，可精准获取所需照片。
• 提供详细的使用文档和技术支持，降低使用门槛。

📦 安装指南

使用预构建二进制文件

根据你的操作系统选择相应的版本：

从源代码构建

git clone https://github.com/okooo5km/unsplash-mcp-server.git
cd unsplash-mcp-server
go build .

📚 详细文档

配置说明

必要环境变量

• UNSPLASH_ACCESS_KEY：用于身份验证的 Unsplash API 访问密钥。请参考 Unsplash 开发文档 获取。

服务配置

创建一个名为 config.json 的文件，内容如下：

{
  "transport": "stdio",
  "port": 8080,
  "api_key": "your_unsplash_api_key_here"
}

使用场景

• 集成到编辑器：为 Cursor、VS Code 等编辑器提供照片搜索功能。
• AI 聊天机器人：增强聊天体验，支持插入图片链接。
• 个人项目：快速添加 Unsplash 照片搜索功能。

命令行参数

支持以下命令行选项：

• -h, --help：显示服务器的帮助信息。
• -v, --version：显示服务器版本号。
• -t, --transport <string>：设置传输类型（默认值："stdio"）
  • stdio：直接与语言模型集成的标准输入输出模式。
  • sse：基于 HTTP 的 Server - Sent Events 模式。
• -p, --port <int>：指定 SSE 模式的监听端口（默认值：8080）。

示例配置

在 Cursor 中的配置

在 Cursor 编辑器的 settings.json 中添加：

{
  "mcpServers": {
    "unsplash": {
      "command": "unsplash-mcp-server",
      "env": {
        "UNSPLASH_ACCESS_KEY": "your_access_key_here"
      }
    }
  }
}

在 Chatwise 中的配置

⚠️ 重要提示

在 Chatwise 中添加环境变量时，请不要使用引号包裹值（修复了 #1 问题）

开发要求

• Go 1.20 或更高版本。
• Unsplash API 访问密钥。
• MCP Go SDK 0.19.0 或更高版本。

💻 使用示例

基础用法

搜索照片

{
  "query": "mountain landscape",
  "per_page": 5,
  "color": "blue",
  "orientation": "landscape"
}

获取照片详细信息

{
  "photoId": "Dwu85P9SOIk"
}

随机获取照片

{
  "count": 3,
  "query": "coffee",
  "orientation": "portrait"
}

📄 许可证

unsplash-mcp-server-go 根据 MIT 许可证发布。这意味着你可以自由地使用、修改和分发此软件，同时保留版权声明和许可声明。

🌟 支持项目

如果你觉得这个项目对你有帮助，请考虑支持它的开发：

• 在 GitHub 上为该项目点星。
• 在问题跟踪器中报告错误或提出功能建议。
• 提交拉取请求以帮助改进代码。
• 贡献到项目的发展。

特别鸣谢