Unsplash Mcp Server Swift

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
  1. 启动服务端:
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 :设置传输协议(默认:stdio)
    • stdio:标准输入输出模式,适用于直接与 LLM 集成
    • sse:Server - Sent Events 模式,支持网络连接
  • -p, --port :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
  • 0 关注
  • 0 收藏,12 浏览
  • system 提出于 2025-09-30 18:09

相似服务问题