Unsplash MCP 服务器

一个用于与 Unsplash API 进行交互的轻量级开源中继服务器，专为编辑器和其他语言模型设计。

特性

• 支持通过 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 照片搜索功能。

示例使用

搜索照片

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

获取照片详细信息

{
  "photoId": "Dwu85P9SOIk"
}

随机获取照片

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

命令行参数

支持以下命令行选项：

• -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 根据 MIT 许可证发布。这意味着你可以自由地使用、修改和分发此软件，同时保留版权声明和许可声明。