dbx-mcp-server
2025.05.08
0
TypeScript文件管理文件管理
dbx-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务，提供与 Dropbox 的集成功能，允许 MCP 兼容的客户端通过一系列强大的工具与 Dropbox 进行交互。该服务支持文件操作、元数据搜索、账户信息获取等功能，适用于需要与 Dropbox 进行集成的开发场景。
View on GitHub
Overview
基本能力
产品定位
dbx-mcp-server 是一个 MCP 服务器，提供与 Dropbox 的集成功能，使 MCP 兼容的客户端能够通过一系列工具与 Dropbox 进行交互。
核心功能
- 文件操作：包括文件上传、下载、列表、安全删除、文件夹创建、文件复制和移动等。
- 元数据和搜索：获取文件/文件夹元数据、搜索文件和文件夹、创建共享链接等。
- 账户操作：获取账户信息。
适用场景
- 需要与 Dropbox 进行集成的开发项目。
- 自动化文件管理任务。
- 需要访问和操作 Dropbox 文件的应用。
工具列表
- list_files：列出目录中的文件。
- upload_file：上传文件。
- download_file：下载文件。
- safe_delete_item：安全删除文件或文件夹（支持回收站）。
- create_folder：创建新文件夹。
- copy_item：复制文件或文件夹。
- move_item：移动或重命名文件/文件夹。
- get_file_metadata：获取文件/文件夹元数据。
- search_file_db：搜索文件和文件夹。
- get_sharing_link：创建共享链接。
- get_file_content：获取文件内容。
- get_account_info：获取账户信息。
常见问题解答
- 如何获取 Dropbox API 密钥？
- 在 Dropbox App Console 注册应用并获取密钥。
- 如何配置 OAuth 2.0 认证？
- 设置环境变量
DROPBOX_APP_KEY、DROPBOX_APP_SECRET、DROPBOX_REDIRECT_URI和TOKEN_ENCRYPTION_KEY。 - 如何运行测试？
- 使用命令
npm test运行测试套件。
使用教程
使用依赖
- 安装 Node.js 和 npm。
- 克隆仓库：
bash git clone https://github.com/your-username/dbx-mcp-server.git cd dbx-mcp-server
安装教程
- 安装依赖并构建项目：
bash npm install npm run build - 运行设置脚本：
bash npm run setup - 配置 MCP 设置文件：
json { "mcpServers": { "dbx": { "command": "node", "args": ["/path/to/dbx-mcp-server/build/index.js"] } } }
调试方式
- 运行测试套件：
bash npm test - 运行特定测试文件或测试组：
bash npm test -- tests/dropbox/search-delete.test.ts npm test -- -t "should search for files"