dbx-mcp-server
by amgadabdelhafez
The dbx-mcp-server is a Model Context Protocol (MCP) server that integrates with Dropbox. It allows MCP-compatible clients to interact with Dropbox through a set of powerful tools.
Last updated: N/A
What is dbx-mcp-server?
The dbx-mcp-server is an intermediary server that translates requests from MCP clients into Dropbox API calls, enabling seamless interaction between MCP environments and Dropbox storage.
How to use dbx-mcp-server?
To use the server, you need to clone the repository, install dependencies, build the project, register a Dropbox app, configure the required environment variables (Dropbox App Key, Secret, Redirect URI, Token Encryption Key), and then configure your MCP client to use the server's endpoint.
Key features of dbx-mcp-server
File operations (list, upload, download, delete, create folder, copy, move)
Metadata and search capabilities
Account information retrieval
OAuth 2.0 authentication with PKCE
Use cases of dbx-mcp-server
Integrating Dropbox storage into MCP-based workflows
Automating file management tasks within Dropbox
Building custom applications that leverage Dropbox's API through MCP
Searching and retrieving files and metadata from Dropbox using MCP clients
FAQ from dbx-mcp-server
Is this project affiliated with Dropbox?
Is this project affiliated with Dropbox?
No, this project is an independent integration and is not affiliated with, endorsed by, or sponsored by Dropbox.
What permissions are required for the Dropbox app?
What permissions are required for the Dropbox app?
The required permissions include files.metadata.read
, files.content.read
, files.content.write
, sharing.write
, and account_info.read
.
What is the purpose of the TOKEN_ENCRYPTION_KEY?
What is the purpose of the TOKEN_ENCRYPTION_KEY?
The TOKEN_ENCRYPTION_KEY is used to encrypt the OAuth tokens for secure storage.
How do I run the tests?
How do I run the tests?
Run npm test
to execute the test suite, which verifies authentication, file operations, and error handling.
What technologies are used to build this server?
What technologies are used to build this server?
The server is built with TypeScript, Model Context Protocol SDK, Dropbox SDK v10.34.0, and Dropbox API v2.