Unsplash MCP 服务器

English | 简体中文

一个简单的 MCP 服务器，用于无缝的 Unsplash 图片集成和搜索功能。

📋 概述

Unsplash MCP 服务器用于搜索丰富、高质量的图片。它非常适合希望将 Unsplash 功能集成到自己的应用程序中的开发人员。

✨ 特性

• 高级图片搜索: 使用以下过滤器搜索 Unsplash 庞大的照片库：
  • 关键词相关性
  • 颜色方案
  • 方向选项
  • 自定义排序和分页

🔑 获取 Unsplash 访问密钥

在安装此服务器之前，您需要获取 Unsplash API 访问密钥：

1. 在 Unsplash 创建一个开发者帐户
2. 注册一个新应用程序
3. 从应用程序详细信息页面获取您的访问密钥
4. 在下面的配置步骤中使用此密钥

有关更多详细信息，请参阅 官方 Unsplash API 文档。

🚀 安装

要通过 Smithery 自动安装用于 Claude Desktop 的 Unsplash 图片集成服务器：

IDE 设置

Cursor IDE

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Windsurf

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Cline

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

手动安装

# 克隆存储库
git clone https://github.com/hellokaton/unsplash-mcp-server.git

# 导航到项目目录
cd unsplash-mcp-server

# 创建虚拟环境
uv venv

# 安装依赖项
uv pip install .

Cursor 编辑器集成

将以下配置添加到您的 Cursor 编辑器的 settings.json：

⚠️ 注意： 请根据您的实际安装调整以下配置：

• 如果 uv 不在您的系统 PATH 中，请使用绝对路径（例如，/path/to/uv）
• ./server.py 应该修改为您服务器脚本的实际位置（可以使用绝对路径或相对于工作区的路径）

<img src="screenshots/Snipaste_1.png" alt="Cursor Configuration Screenshot" />

{
  "mcpServers": {
    "unsplash": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
      }
    }
  }
}

在 Cursor 中使用

<img src="screenshots/Snipaste_2.png" alt="Unsplash MCP in Cursor" />

🛠️ 可用工具

搜索照片

{
  "tool": "search_photos",
  "query": "mountain",
  "per_page": 5,
  "orientation": "landscape"
}

🔄 其他实现

• Golang: unsplash-mcp-server
• Java: unsplash-mcp-server

📄 许可证

MIT License

📬 联系方式

• Twitter/X
• GitHub Issues