概要
What is dbx-mcp-server?
dbx-mcp-server is a Model Context Protocol (MCP) server that integrates with Dropbox, enabling MCP-compatible clients to interact with Dropbox through a set of tools. It is an independent, unaffiliated project that uses Dropbox’s public API.
How to use dbx-mcp-server?
Clone the repository, run npm install, npm run build, and npm run setup. Then configure your MCP client with the command node and the path to the built index.js file. You must register a Dropbox app, set up OAuth 2.0 with PKCE, and provide environment variables: DROPBOX_APP_KEY, DROPBOX_APP_SECRET, DROPBOX_REDIRECT_URI, and TOKEN_ENCRYPTION_KEY.
Key features of dbx-mcp-server
- List, upload, download, and delete files
- Create, copy, and move files and folders
- Retrieve file metadata and contents
- Search files and folders by query
- Create sharing links
- Get Dropbox account information
Use cases of dbx-mcp-server
- List files in any Dropbox directory
- Upload a file to a specified path
- Download a file’s content
- Search for files across folders
- Generate shareable links for files
FAQ from dbx-mcp-server
What tools does dbx-mcp-server provide?
File operations (list, upload, download, delete, create folder, copy, move), metadata and search (get metadata, search, create sharing link, get content), and account info.
How is authentication handled?
It uses OAuth 2.0 with PKCE. You must supply a Dropbox app key, secret, redirect URI, and an encryption key for tokens.
What Dropbox permissions are required?
Scopes include files.metadata.read, files.content.read, files.content.write, sharing.write, and account_info.read. Additional optional scopes are listed in the README.
What are the dependencies?
The server is built with TypeScript, the Model Context Protocol SDK, and the Dropbox SDK v10.34.0 for Dropbox API v2.
Is dbx-mcp-server affiliated with Dropbox?
No. The project is an independent integration and is not endorsed or sponsored by Dropbox.
