JinDaGe - unsplash-mcp-server-go MCP Details

article

README

🚀 Unsplash MCP 服务器

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

🚀 快速开始

安装

本项目提供了两种安装方式，你可以根据自己的需求进行选择。

使用预构建二进制文件

根据你的操作系统选择相应的版本： | 操作系统 | 下载链接 | |--------|---------| | Windows | 下载 | | macOS | 下载 | | Linux 64 - bit | 下载 |

从源代码构建

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"
}

✨ 主要特性

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

💻 使用示例

基础用法

搜索照片

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

获取照片详细信息

{
  "photoId": "Dwu85P9SOIk"
}

随机获取照片

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

📚 详细文档

使用场景

集成到编辑器：为 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 或更高版本。

支持项目

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

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

unsplash-mcp-server-go