{"_id":"@dawnswwwww/unsplash-mcp-server","_rev":"2-88922d0a6dd9602faa47664df781ff8e","name":"@dawnswwwww/unsplash-mcp-server","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.1":{"name":"@dawnswwwww/unsplash-mcp-server","version":"0.0.1","keywords":["mcp","unsplash","photos","images","api","server"],"author":{"name":"Dawn"},"license":"MIT","_id":"@dawnswwwww/unsplash-mcp-server@0.0.1","maintainers":[{"name":"dawnswwwww","email":"wxn_em@163.com"}],"homepage":"https://github.com/dawnswwwww/unsplash-mcp-server#readme","bugs":{"url":"https://github.com/dawnswwwww/unsplash-mcp-server/issues"},"bin":{"unsplash-mcp-server":"dist/index.js"},"dist":{"shasum":"6f14f21977366d760d21589a94c2d942c5bcc786","tarball":"https://registry.npmjs.org/@dawnswwwww/unsplash-mcp-server/-/unsplash-mcp-server-0.0.1.tgz","fileCount":5,"integrity":"sha512-qTX3+mI9z4Sxa/BR9LHK3J2YcuMgHMdJ+B+bBd/2N+X9nuAWJXHWXCUwWnss4kmFAfGHteG4vs30QI+m8J4Y4A==","signatures":[{"sig":"MEUCIQCcMstfbO2SBtajw2fAaGRWvCQdF8iJedSOycIeyOiG/wIgPxnpTeol+eCf9Ja9THvscazSJoY0AqsyYFeO6Vgc3Gw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28886},"main":"./dist/index.js","type":"module","_from":"file:dawnswwwww-unsplash-mcp-server-0.0.1.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":"./dist/index.js","./package.json":"./package.json"},"scripts":{"dev":"tsx src/index.ts","lint":"eslint --cache .","test":"vitest","build":"tsdown","start":"node dist/index.js","watch":"tsdown --watch","format":"prettier --cache --write .","release":"bumpp && pnpm publish","lint:fix":"pnpm run lint --fix","typecheck":"tsc --noEmit","test:coverage":"vitest --coverage"},"_npmUser":{"name":"dawnswwwww","email":"wxn_em@163.com"},"prettier":"@sxzz/prettier-config","_resolved":"/private/var/folders/0q/hd87hwcn4l7gd87xydbp9d0h0000gn/T/82a688074204787ff39d2745bab2233d/dawnswwwww-unsplash-mcp-server-0.0.1.tgz","_integrity":"sha512-qTX3+mI9z4Sxa/BR9LHK3J2YcuMgHMdJ+B+bBd/2N+X9nuAWJXHWXCUwWnss4kmFAfGHteG4vs30QI+m8J4Y4A==","repository":{"url":"git+https://github.com/dawnswwwww/unsplash-mcp-server.git","type":"git"},"_npmVersion":"10.9.0","description":"A powerful Model Context Protocol server for Unsplash photo search and retrieval","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","bumpp":"^10.1.0","eslint":"^9.26.0","tsdown":"^0.11.9","vitest":"^3.1.3","prettier":"^3.5.3","happy-dom":"^17.4.7","typescript":"^5.8.3","@types/node":"^22.15.17","@sxzz/eslint-config":"^7.0.1","@sxzz/prettier-config":"^2.2.1"},"_npmOperationalInternal":{"tmp":"tmp/unsplash-mcp-server_0.0.1_1749663337063_0.06610412781478825","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@dawnswwwww/unsplash-mcp-server","version":"0.0.2","description":"A powerful Model Context Protocol server for Unsplash photo search and retrieval","type":"module","keywords":["mcp","unsplash","photos","images","api","server"],"license":"MIT","homepage":"https://github.com/dawnswwwww/unsplash-mcp-server#readme","bugs":{"url":"https://github.com/dawnswwwww/unsplash-mcp-server/issues"},"repository":{"type":"git","url":"git+https://github.com/dawnswwwww/unsplash-mcp-server.git"},"author":{"name":"Dawn"},"main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":"./dist/index.js","./package.json":"./package.json"},"bin":{"unsplash-mcp-server":"dist/index.js"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.24.1"},"devDependencies":{"@sxzz/eslint-config":"^7.0.1","@sxzz/prettier-config":"^2.2.1","@types/node":"^22.15.17","bumpp":"^10.1.0","eslint":"^9.26.0","happy-dom":"^17.4.7","prettier":"^3.5.3","tsdown":"^0.11.9","tsx":"^4.19.4","typescript":"^5.8.3","vitest":"^3.1.3"},"prettier":"@sxzz/prettier-config","scripts":{"dev":"tsx src/index.ts","build":"tsdown","watch":"tsdown --watch","start":"node dist/index.js","test":"vitest","test:coverage":"vitest --coverage","typecheck":"tsc --noEmit","lint":"eslint --cache .","lint:fix":"pnpm run lint --fix","format":"prettier --cache --write .","release":"bumpp && pnpm publish"},"_id":"@dawnswwwww/unsplash-mcp-server@0.0.2","_integrity":"sha512-+kdzwBGEK61PbZp+om5+rkirEoBzOe/Aog9BIGl05plKfz8CpEw0uH82Ug0e00pgGLGpEc6TOrdJCT3apiKfkQ==","_resolved":"/private/var/folders/0q/hd87hwcn4l7gd87xydbp9d0h0000gn/T/9f67fab1fa5f0b34b5419ea2a0708e42/dawnswwwww-unsplash-mcp-server-0.0.2.tgz","_from":"file:dawnswwwww-unsplash-mcp-server-0.0.2.tgz","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-+kdzwBGEK61PbZp+om5+rkirEoBzOe/Aog9BIGl05plKfz8CpEw0uH82Ug0e00pgGLGpEc6TOrdJCT3apiKfkQ==","shasum":"7ecdd01e5802ddf3f4b9828ae29c5b993a2418d7","tarball":"https://registry.npmjs.org/@dawnswwwww/unsplash-mcp-server/-/unsplash-mcp-server-0.0.2.tgz","fileCount":5,"unpackedSize":28886,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAnOuaU/ZSj4y/WvKdtN/PZJWAQ8Uq/3/UVArq4AOYGBAiEAoCdhN/qXDvhbfEeIPist2n9fK8kB2FXUllWmh4qOy/Q="}]},"_npmUser":{"name":"dawnswwwww","email":"wxn_em@163.com"},"directories":{},"maintainers":[{"name":"dawnswwwww","email":"wxn_em@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/unsplash-mcp-server_0.0.2_1749663484211_0.0929189952994327"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-11T17:35:37.005Z","modified":"2025-06-11T17:38:04.554Z","0.0.1":"2025-06-11T17:35:37.247Z","0.0.2":"2025-06-11T17:38:04.375Z"},"bugs":{"url":"https://github.com/dawnswwwww/unsplash-mcp-server/issues"},"author":{"name":"Dawn"},"license":"MIT","homepage":"https://github.com/dawnswwwww/unsplash-mcp-server#readme","keywords":["mcp","unsplash","photos","images","api","server"],"repository":{"type":"git","url":"git+https://github.com/dawnswwwww/unsplash-mcp-server.git"},"description":"A powerful Model Context Protocol server for Unsplash photo search and retrieval","maintainers":[{"name":"dawnswwwww","email":"wxn_em@163.com"}],"readme":"# @dawnswwwww/unsplash-mcp-server\n\n🖼️ **强大的 Unsplash Model Context Protocol 服务器**\n\n一个专为 AI 助手设计的 Unsplash 图片搜索和检索 MCP 服务器，支持智能搜索、随机图片和详细信息获取。\n\n[![npm version](https://img.shields.io/npm/v/@dawnswwwww/unsplash-mcp-server.svg)](https://www.npmjs.com/package/@dawnswwwww/unsplash-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## ✨ 特性\n\n- 🔍 **智能图片搜索** - 支持关键词、颜色、方向等多维度搜索\n- 🎲 **随机图片获取** - 可配置过滤条件的随机图片\n- 📋 **详细图片信息** - 包含 EXIF 数据、位置信息和摄影师详情\n- 🚀 **即开即用** - 通过 `npx -y @dawnswwwww/unsplash-mcp-server` 直接使用\n- 🔒 **类型安全** - 完全使用 TypeScript 编写，严格类型检查\n- 🌐 **标准兼容** - 基于官方 MCP SDK 实现\n\n## 🚀 快速开始\n\n### 使用 npx（推荐）\n\n```bash\nnpx -y @dawnswwwww/unsplash-mcp-server\n```\n\n### 获取 Unsplash API 密钥\n\n1. 访问 [Unsplash Developers](https://unsplash.com/developers)\n2. 注册并创建新应用\n3. 获取您的 Access Key\n\n### 配置 Claude Desktop\n\n在您的 Claude Desktop 配置文件中添加：\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"unsplash\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dawnswwwww/unsplash-mcp-server\"],\n      \"env\": {\n        \"UNSPLASH_ACCESS_KEY\": \"your-access-key-here\"\n      }\n    }\n  }\n}\n```\n\n## 🛠️ 可用工具\n\n### `search_photos` - 搜索图片\n\n```typescript\n{\n  \"query\": \"mountain landscape\",      // 搜索关键词\n  \"page\": 1,                        // 页码 (可选)\n  \"per_page\": 10,                   // 每页数量 (可选, 1-30)\n  \"order_by\": \"relevant\",           // 排序方式 (可选: relevant, latest)\n  \"color\": \"blue\",                  // 颜色过滤 (可选)\n  \"orientation\": \"landscape\"        // 方向过滤 (可选: landscape, portrait, squarish)\n}\n```\n\n### `get_photo` - 获取图片详情\n\n```typescript\n{\n  \"photoId\": \"Dwu85P9SOIk\"          // 图片 ID\n}\n```\n\n### `random_photo` - 获取随机图片\n\n```typescript\n{\n  \"count\": 1,                       // 图片数量 (可选, 默认: 1, 最大: 30)\n  \"query\": \"coffee\",                // 搜索关键词 (可选)\n  \"orientation\": \"portrait\",        // 方向过滤 (可选)\n  \"featured\": true                  // 仅精选图片 (可选)\n}\n```\n\n## 🧪 测试\n\n### 使用测试客户端\n\n我们提供了一个专门的测试客户端来验证 MCP 服务器的功能：\n\n```bash\n# 进入测试客户端目录\ncd test-client\n\n# 安装依赖\nnpm install\n\n# 设置 API 密钥\nexport UNSPLASH_ACCESS_KEY=\"your-access-key-here\"\n\n# 运行所有测试\nnpm test\n\n# 运行特定测试\nnpm run test:search    # 测试搜索功能\nnpm run test:get       # 测试获取照片详情\nnpm run test:random    # 测试随机照片\n```\n\n测试客户端会：\n\n- ✅ 自动连接到 MCP 服务器\n- ✅ 测试所有三个工具的功能\n- ✅ 提供详细的测试报告和时间统计\n- ✅ 验证响应格式和数据完整性\n\n### 测试输出示例\n\n```\n🧪 Unsplash MCP 服务器测试客户端\n=====================================\n✅ 连接成功!\n📋 测试工具列表...\n✅ 找到 3 个工具: search_photos, get_photo, random_photo\n🔍 测试搜索功能...\n✅ 搜索测试成功\n📊 测试总结: 4/4 测试通过\n```\n\n## 🏗️ 本地开发\n\n```bash\n# 克隆仓库\ngit clone https://github.com/dawnswwwww/unsplash-mcp-server.git\ncd unsplash-mcp-server\n\n# 安装依赖\npnpm install\n\n# 设置环境变量\nexport UNSPLASH_ACCESS_KEY=\"your-access-key-here\"\n\n# 开发模式\npnpm dev\n\n# 构建\npnpm build\n\n# 运行测试\npnpm test\n```\n\n## 📖 示例使用\n\n### 在 Claude 中搜索图片\n\n```\n请帮我找几张关于\"日出山景\"的风景照片，要求是横向构图的。\n```\n\nClaude 将自动调用 `search_photos` 工具：\n\n```json\n{\n  \"query\": \"sunrise mountain landscape\",\n  \"orientation\": \"landscape\",\n  \"per_page\": 5\n}\n```\n\n### 获取随机图片\n\n```\n给我推荐一张随机的咖啡主题图片。\n```\n\nClaude 将调用 `random_photo` 工具：\n\n```json\n{\n  \"query\": \"coffee\",\n  \"count\": 1\n}\n```\n\n## 🔧 环境变量\n\n| 变量名                | 必需 | 描述                  |\n| --------------------- | ---- | --------------------- |\n| `UNSPLASH_ACCESS_KEY` | ✅   | Unsplash API 访问密钥 |\n\n## 🤝 贡献\n\n欢迎贡献代码！请查看我们的贡献指南。\n\n## 📄 许可证\n\nMIT License - 详见 [LICENSE](LICENSE) 文件。\n\n## 🙏 致谢\n\n- [Unsplash](https://unsplash.com/) - 提供高质量的免费图片\n- [Model Context Protocol](https://modelcontextprotocol.io/) - 标准化的 AI 上下文协议\n- 参考了 [hellokaton/unsplash-mcp-server](https://github.com/hellokaton/unsplash-mcp-server) 和其他优秀的开源项目\n","readmeFilename":"README.md"}