dbx-mcp-server logo

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.

View on GitHub

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?

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?

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?

The TOKEN_ENCRYPTION_KEY is used to encrypt the OAuth tokens for secure storage.

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?

The server is built with TypeScript, Model Context Protocol SDK, Dropbox SDK v10.34.0, and Dropbox API v2.