Unsplash MCP 服务器

快速入门

1. 获取 Unsplash Access Key

   • 注册 Unsplash 开发者账号 并创建应用。
   • 获取 Access Key。

2. 安装方式

   • 使用 Smithery 自动安装：

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

   • 手动安装：

     git clone https://github.com/hellokaton/unsplash-mcp-server.git
     cd unsplash-mcp-server
     uv venv
     uv pip install .
     

3. 配置 Cursor IDE 在 settings.json 中添加以下内容：

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

4. 使用 Search Photos 工具 请求示例：

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