mybox-mcp
Provides tools for interacting with a cloud storage (MYBOX) Open API, enabling file and folder management: listing and inspecting storage, root and folder contents; creating folders; generating upload/download URLs; copying, moving, renaming, deleting, and favoriting resources; searching files and folders; and managing the trash (listing, restoring, permanently deleting, emptying, and setting auto-delete routines).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mybox-mcp show me the files in my MYBOX root folder"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mybox-mcp (Unofficial)
네이버 클라우드 MYBOX Open API를 위한 공식 비공식 MCP(Model Context Protocol) 서버입니다.
제공되는 모든 API는 네이버 MYBOX Open API 스펙을 기반으로 작성되었으며, 파일 및 폴더 조회, 업로드/다운로드, 복사/이동, 휴지통 관리 등 홈페이지에 명시된 20개 전체 API 기능을 100% 지원합니다.
참고: 본 프로젝트는 네이버 클라우드 공식 프로젝트가 아니며, 개인 액세스 토큰 유출 시 발생하는 책임은 사용자에게 있습니다.
지원 API 목록
도구 (Tool) | 설명 | 파라미터 (주요 필드) |
| 내 파일 속성(용량, 갯수 등) 조회 | - |
| 루트 파일/폴더 목록 조회 |
|
| 특정 폴더 내 파일/폴더 목록 조회 |
|
| 개별 파일/폴더 속성 조회 |
|
| 폴더 생성 |
|
| 파일 업로드 URL 생성 |
|
| 파일 다운로드 URL 생성 |
|
| 파일/폴더 복사 |
|
| 파일/폴더 삭제 |
|
| 파일/폴더 이동 |
|
| 파일/폴더 이름 변경 |
|
| 파일/폴더 즐겨찾기 추가 |
|
| 파일/폴더 즐겨찾기 해제 |
|
| 파일 검색 |
|
| 폴더 검색 |
|
| 휴지통 파일/폴더 목록 조회 |
|
| 휴지통 파일/폴더 복원 |
|
| 휴지통 개별 영구 삭제 |
|
| 휴지통 전체 비우기 | - |
| 휴지통 자동 삭제 주기 설정 |
|
Related MCP server: MCP Google Drive Server
주요 특징 및 정책
완벽한 파라미터 매핑: MYBOX API에서 요구하는 필수 및 선택 파라미터, 바디 값 등을 모두
zod스키마로 완벽하게 규격화했습니다.표준 HTTP 통신:
axios를 활용하여 빠르고 안정적인 API 통신을 수행합니다.Node 호환성: Node.js 20, 22, 24 환경을 완벽하게 지원합니다.
보안 유의:
MYBOX_ACCESS_TOKEN개인 액세스 토큰은 절대 외부에 노출되지 않도록 주의하세요.
설정 방법
사용하시는 클라이언트(Cursor, Claude Desktop 등)의 mcp_config.json 설정에 다음 내용을 추가하세요:
{
"mcpServers": {
"mybox-mcp": {
"command": "npx",
"args": ["-y", "github:minking/mybox-mcp"],
"env": {
"MYBOX_ACCESS_TOKEN": "발급받은_MYBOX_개인액세스토큰"
}
}
}
}라이선스
MIT License (c) 2026 minking
Available Tools
20 toolsdms_favoriteC
즐겨찾기 표시
Inputs: resourceId (required).
dms_listC
특정 폴더 내 파일/폴더 목록 조회
Inputs: resourceId (required), sort, limit, order, +1 more.
dms_resourceIdB
개별 파일/폴더 속성 조회
Inputs: resourceId (required).
dms_rootC
루트 파일/폴더 목록 조회
Inputs: sort, limit, order, offset.
dms_storageC
내 파일 속성 조회
Inputs: no named parameters.
dms_trash_listC
휴지통 목록 조회
Inputs: sort, limit, order, offset.
dms_trash_routineC
휴지통 자동 삭제 주기 설정
Inputs: trashAutoDeleteDays (required).
dms_unfavoriteC
즐겨찾기 해제
Inputs: resourceId (required).
files_copyC
파일/폴더 복사
Inputs: resourceId (required), name, parentId, isOverwrite.
files_create_folderD
폴더 생성
Inputs: folderName (required), parentId.
files_deleteC
파일/폴더 삭제
Inputs: resourceIds (required).
files_downloadC
파일 다운로드 URL 생성
Inputs: resourceId (required).
files_moveC
파일/폴더 이동
Inputs: parentId (required), resourceId (required), isOverwrite.
files_renameC
파일/폴더 이름 변경
Inputs: name (required), resourceId (required).
files_trash_cleanB
휴지통 전체 삭제
Inputs: no named parameters.
files_trash_clean_resourceIdB
휴지통 특정 파일 삭제 (영구삭제)
Inputs: resourceId (required).
files_trash_restoreD
휴지통 복원
Inputs: resourceId (required), isOverwrite.
files_uploadC
파일 업로드 URL 생성
Inputs: fileName (required), fileSize (required), offset, resume, +3 more.
search_files_resourcesD
파일 검색
Inputs: query (required), sort, type, limit, +2 more.
search_folders_resourcesD
폴더 검색
Inputs: query (required), sort, limit, order, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Most tools target a distinct resource+action (list, copy, move, rename, delete, trash, favorite, search). Minor overlap exists between dms_storage and dms_resourceId (both 'property inquiry') and between dms_root and dms_list, but descriptions clarify most boundaries.
Three prefix families coexist (dms_, files_, search_) with mixed structure: some dms_ tools are nouns (dms_storage, dms_root), others are verbs (dms_favorite, dms_unfavorite), plus camelCase suffixes (dms_resourceId, files_trash_clean_resourceId) mixed with snake_case. Still readable but not one predictable pattern.
At 20 tools the surface is on the heavy side for a file manager, but each tool maps to a genuine operation (CRUD, trash lifecycle, search, favorites, storage). A few could be consolidated (search_files/search_folders, dms_root/dms_list) but nothing feels redundant filler.
Strong lifecycle coverage: list/properties, create folder, upload/download, copy/move/rename/delete, full trash management (list/restore/clean/clean-one/routine), search, and favorites. Gaps are secondary features like sharing/permissions, file creation, or versioning rather than core workflows.
Related MCP Connectors
Browse and manage files in your Moxt AI workspace from any MCP client.
Persistent file storage for AI agents via MCP and curl. Upload, download, and version files.
File uploads for AI agents. Upload, list, and manage files. No signup required.
Hosted file storage for agents: upload, list, download, share by link, expire, scratch.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access Yifangyun cloud drive via MCP, supporting queries of enterprise organization, department folders, file details, and download links.20 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Google Drive, supporting file operations like list, search, read, create, update, delete, share, and manage permissions.7405 npm4MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Box files, folders, collaborations, and more via the Box API using tools for search, upload, and metadata operations.5 npmISC
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage files on Synology NAS via the File Station API, supporting operations like browsing, searching, uploading/downloading, creating, renaming, copying, moving, deleting, compressing, and extracting.MIT