{"_id":"@aitutorlab/unsplash-mcp","name":"@aitutorlab/unsplash-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aitutorlab/unsplash-mcp","version":"1.0.0","description":"Unsplash API integration for Model Context Protocol","type":"module","main":"dist/index.js","bin":{"unsplash-mcp":"dist/index.js"},"scripts":{"build":"tsc","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","axios":"^1.0.0","dotenv":"^16.0.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"_id":"@aitutorlab/unsplash-mcp@1.0.0","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-PbpdM+dnS1NqHJPrsh29/B/uhAsW29CK7L9fQwPFieaSnQsukvW/FqoSHHH2RIWJ5W9qiUo0+gJq4wr1gTludg==","shasum":"e63612fb7121b616600e78141aae15eea75c4234","tarball":"https://registry.npmjs.org/@aitutorlab/unsplash-mcp/-/unsplash-mcp-1.0.0.tgz","fileCount":3,"unpackedSize":11582,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDTzEti0RsD4VfWcU67564YLGWqfuxmVe3iR3hoo3OWSAiEA/QdPwuXZPzVJ46dkN2Xmeo0rXIONgs28Ns9P+VGMOX8="}]},"_npmUser":{"name":"aitutorlab","email":"aitutor0001@gmail.com"},"directories":{},"maintainers":[{"name":"aitutorlab","email":"aitutor0001@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/unsplash-mcp_1.0.0_1778993753674_0.6181732199119157"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-17T04:55:53.554Z","1.0.0":"2026-05-17T04:55:53.822Z","modified":"2026-05-17T04:55:54.091Z"},"maintainers":[{"name":"aitutorlab","email":"aitutor0001@gmail.com"}],"description":"Unsplash API integration for Model Context Protocol","readme":"# Unsplash MCP Server\n\n이 프로젝트는 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)을 지원하는 어플리케이션(Claude Desktop, Cursor 등)에서 Unsplash의 사진 검색 및 데이터 기능을 연동하여 사용할 수 있도록 해주는 MCP 서버입니다.\n\n## 기능 (Features)\n\n이 서버는 다음과 같은 툴(Tools)을 제공합니다:\n- `search_photos`: 키워드, 색상, 방향 등의 필터를 기반으로 사진 검색\n- `get_random_photo`: 랜덤 사진 가져오기 (키워드, 컬렉션 제한 가능)\n- `list_topics`: Unsplash에서 관리하는 토픽(카테고리) 목록 조회\n- `get_topic_photos`: 특정 토픽의 사진 조회\n- `get_collection_photos`: 특정 컬렉션의 사진 조회\n- `get_photo`: 단일 사진의 상세 정보 조회\n- `get_photo_statistics`: 특정 사진의 조회수 및 다운로드 통계 확인\n\n## 사전 준비 (Prerequisites)\n\n이 서버를 사용하려면 Unsplash Developer 계정과 API Access Key가 필요합니다.\n1. [Unsplash Developers](https://unsplash.com/developers)에 접속하여 회원가입/로그인합니다.\n2. 새 애플리케이션을 생성합니다.\n3. 발급된 **Access Key**를 복사합니다.\n\n## 설치 및 사용 (Installation & Usage)\n\n### Claude Desktop에서 사용하기\n\nClaude Desktop의 환경설정 파일(`mcp_config.json`)을 열고 아래와 같이 등록합니다.\n\n- **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"unsplash-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@aitutorlab/unsplash-mcp\"\n      ],\n      \"env\": {\n        \"UNSPLASH_ACCESS_KEY\": \"여기에_발급받으신_언스플래시_키_입력\"\n      }\n    }\n  }\n}\n```\n\n설정 후 Claude Desktop을 재시작하면 Claude가 필요에 따라 자동으로 이 서버의 툴을 호출하여 이미지를 검색합니다.\n\n## 라이선스\nISC License\n","readmeFilename":"README.md","_rev":"1-da2de1cf246b874eecc4fc12234fce5a"}