u
unsplash图片浏览
MicroLee/unsplash-server
Hosted
1 Stars
335 次浏览
更新于 2026-08-23
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"unsplash": {
"alwaysAllow": [],
"args": [
"-y",
"@microlee666/unsplash-mcp-server"
],
"command": "npx",
"disabled": false,
"disabledTools": [],
"env": {}
}
}
}该服务需要配置环境变量：UNSPLASH_ACCESS_KEY
可用工具 （15 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
search_photos 6 个参数 需填 1 项
必填参数：query
get_photo 1 个参数 需填 1 项
必填参数：id
list_photos 3 个参数
该工具无需必填参数，直接调用即可
get_random_photo 7 个参数
该工具无需必填参数，直接调用即可
track_download 1 个参数 需填 1 项
必填参数：id
list_collections 2 个参数
该工具无需必填参数，直接调用即可
get_collection 1 个参数 需填 1 项
必填参数：id
get_collection_photos 4 个参数 需填 1 项
必填参数：id
list_topics 3 个参数
该工具无需必填参数，直接调用即可
get_topic 1 个参数 需填 1 项
必填参数：id_or_slug
get_topic_photos 5 个参数 需填 1 项
必填参数：id_or_slug
get_user 1 个参数 需填 1 项
必填参数：username
get_user_photos 5 个参数 需填 1 项
必填参数：username
get_user_likes 5 个参数 需填 1 项
必填参数：username
get_user_collections 3 个参数 需填 1 项
必填参数：username
服务介绍
Unsplash MCP Server
一个基于 Model Context Protocol 的 Unsplash 工具服务器，提供搜索、照片详情、随机照片、集合、主题、用户等 15 个工具。
功能列表
照片相关工具 (Photos)
- search_photos - 按关键词搜索 Unsplash 照片，支持分页、排序、颜色筛选和方向筛选
- get_photo - 根据照片 ID 获取单张照片的详细信息，包括作者、尺寸、下载链接等
- list_photos - 列出 Unsplash 最新、最热门或最旧的照片列表，支持分页
- get_random_photo - 获取随机照片，可按关键词、集合、主题、用户等条件筛选
- track_download - 追踪照片下载事件（Unsplash API 要求），在用户下载照片时必须调用
集合相关工具 (Collections)
- list_collections - 列出 Unsplash 上的照片集合，支持分页浏览
- get_collection - 根据集合 ID 获取集合的详细信息，包括标题、描述、照片数量等
- get_collection_photos - 获取指定集合中的所有照片，支持分页和方向筛选
主题相关工具 (Topics)
- list_topics - 列出 Unsplash 上的所有主题分类，支持按最新、最旧或位置排序
- get_topic - 根据主题 ID 或 slug 获取主题的详细信息
- get_topic_photos - 获取指定主题下的照片，支持分页、排序和方向筛选
用户相关工具 (Users)
- get_user - 根据用户名获取 Unsplash 用户的公开信息，包括简介、作品数量等
- get_user_photos - 获取指定用户上传的所有照片，支持分页、排序和方向筛选
- get_user_likes - 获取指定用户点赞（喜欢）的照片列表，支持分页、排序和方向筛选
- get_user_collections - 获取指定用户创建的照片集合列表，支持分页
安装与构建
npm install
npm run build
运行
UNSPLASH_ACCESS_KEY=your_key node build/index.js
MCP 配置示例
{
"mcpServers": {
"unsplash": {
"command": "npx",
"args": [
"-y",
"@microlee666/unsplash-mcp-server"
],
"env": {
"UNSPLASH_ACCESS_KEY": ""
},
"disabled": false,
"alwaysAllow": [],
"disabledTools": []
}
}
}
发布到 npm
需先登录 npm 并确保包名未被占用：
npm login
npm publish --registry https://registry.npmjs.org
