Unsplash MCP 服务端（unsplash-mcp-server）

一个用于与Unsplash API交互的MCP服务器工具，支持通过命令行或网络接口调用。该服务器为语言模型或其他应用程序提供无缝的Unsplash图片搜索和获取功能。

安装指南

安装依赖

• Go 1.20 或更高版本
• Unsplash API访问密钥

安装软件包

go get github.com/okooo5km/unsplash-mcp-server-go@latest

快速启动

安装完成后，可以直接运行服务端：

unsplash-mcp-server --help

配置指南

环境变量配置

在settings.json中添加以下内容：

{
  "mcpServers": {
    "unsplash": {
      "command": "unsplash-mcp-server",
      "env": {
        "UNSPLASH_API_KEY": "your_unsplash_api_key"
      }
    }
  }
}

参数配置

服务器支持以下参数：

• -h, --help: 显示帮助信息
• -v, --version: 显示版本号
• -t, --transport <string>: 设置传输协议（默认：stdio）
  • stdio: 标准输入输出模式，适用于直接与LLM集成
  • sse: Server-Sent Events 模式，支持网络连接
• -p, --port <int>: SSE模式下的监听端口（默认：8080）

使用示例

图片搜索

{
  "query": "自然风光",
  "per_page": 5,
  "color": "蓝色",
  "orientation": "横版"
}

获取图片详情

{
  "photoId": "Dwu85P9SOIk"
}

随机图片获取

{
  "count": 3,
  "query": "咖啡",
  "orientation": "竖版"
}

开发要求

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

示例系统提示语

你可以使用以下系统提示帮助Claude更好地利用unsplash-mcp-server：

1. 使用search_photos工具搜索任意主题的图片
2. 通过get_photo获取特定图片的详细信息
3. 使用random_photo工具获取符合筛选条件的随机图片
4. 在用户请求图片时，使用这些工具查找相关Unsplash图片并附上URL链接

历史版本

更多历史更新请查看GitHub发行说明。

支持项目

如果觉得这个项目对你有帮助，请通过以下方式支持：

• ⭐️ 给项目点个Star

• 🐛 提交问题或功能建议

• 🔄 提交Pull Request改进代码

• 💝 捐助：

许可证

本项目基于MIT许可证开源，具体内容如下：

MIT License
版权所有 (c) 2024, okooo5km
许可条款见随附的LICENSE文件或 https://opensource.org/licenses/MIT