Unsplash MCP Server Swift

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

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

🚀 快速开始

你可以按照下面的步骤快速启动 Unsplash MCP 服务端：

1. 确保安装了 Go 1.20 或更高版本以及 Unsplash API 访问密钥。
2. 安装软件包：

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

3. 启动服务端：

unsplash-mcp-server --help

✨ 主要特性

• 多方式调用：支持通过命令行或网络接口调用，使用灵活。
• 无缝集成：为语言模型或其他应用程序提供无缝的 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）

开发要求

• 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 改进代码

• 💝 捐助：

💻 使用示例

基础用法

图片搜索

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

获取图片详情

{
  "photoId": "Dwu85P9SOIk"
}

随机图片获取

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

📄 许可证

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

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