dbx-mcp-server
2025.05.08
0
TypeScript文件管理文件管理
dbx-mcp-server 是一个 Model Context Protocol (MCP) 服务器，提供与 Dropbox 的集成，允许 MCP 兼容的客户端通过一组强大的工具与 Dropbox 进行交互。该服务器使用 Dropbox 的公共 API，是一个独立的集成项目，与 Dropbox 无官方关联。
View on GitHub
Overview
基本能力
产品定位
dbx-mcp-server 是一个用于与 Dropbox 集成的 MCP 服务器，提供文件管理、元数据查询和账户操作等功能。
核心功能
- 文件操作：包括列出文件、上传文件、下载文件、安全删除、创建文件夹、复制和移动文件/文件夹等。
- 元数据和搜索：获取文件/文件夹元数据、搜索文件和文件夹、创建共享链接、获取文件内容等。
- 账户操作：获取账户信息。
适用场景
- 需要与 Dropbox 进行集成的 MCP 客户端。
- 需要自动化文件管理和元数据查询的应用。
- 需要访问 Dropbox 账户信息的应用。
工具列表
- File Operations：
list_files：列出目录中的文件。upload_file：上传文件。download_file：下载文件。safe_delete_item：安全删除（支持回收站）。create_folder：创建新文件夹。copy_item：复制文件或文件夹。move_item：移动或重命名文件/文件夹。- Metadata and Search：
get_file_metadata：获取文件/文件夹元数据。search_file_db：搜索文件和文件夹。get_sharing_link：创建共享链接。get_file_content：获取文件内容。- Account Operations：
get_account_info：获取账户信息。
常见问题解答
- 如何注册 Dropbox 应用：需要在 Dropbox 开发者控制台注册应用，选择 "Scoped access" API，并设置必要的权限和重定向 URI。
- 如何配置环境变量：需要设置
DROPBOX_APP_KEY、DROPBOX_APP_SECRET、DROPBOX_REDIRECT_URI和TOKEN_ENCRYPTION_KEY等环境变量。
使用教程
使用依赖
- 安装 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" - 如果测试失败，检查
tests/setup.ts中的模拟实现是否正确配置。