dbx-mcp-server

基本能力

产品定位

dbx-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务器，提供与 Dropbox 的集成功能，允许 MCP 兼容的客户端通过一系列强大的工具与 Dropbox 进行交互。

核心功能

• 文件操作：包括上传、下载、删除、复制、移动文件等。
• 元数据和搜索：获取文件元数据、搜索文件和文件夹、创建共享链接等。
• 账户操作：获取账户信息。

适用场景

• 需要与 Dropbox 进行集成的开发项目。
• 需要自动化文件操作的应用场景。
• 需要访问 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 App Console。
• 选择 "Scoped access" API。
• 选择应用所需的访问类型。
• 命名应用并点击 "Create app"。
• 在 "Permissions" 下选择所需的权限。
• 添加 http://localhost:3000/callback 作为重定向 URI。
• 记录 App key 和 App secret。

使用教程

使用依赖

1. 安装 Node.js 和 npm。
2. 克隆仓库： bash git clone https://github.com/your-username/dbx-mcp-server.git cd dbx-mcp-server

安装教程

1. 安装依赖并构建项目： bash npm install npm run build
2. 运行设置脚本： bash npm run setup
3. 添加到 MCP 设置文件： json { "mcpServers": { "dbx": { "command": "node", "args": ["/path/to/dbx-mcp-server/build/index.js"] } } }

调试方式

1. 运行测试套件： bash npm test
2. 运行特定测试文件或测试组： bash npm test -- tests/dropbox/search-delete.test.ts npm test -- -t "should search for files"
3. 如果测试失败，检查 tests/setup.ts 中的模拟实现是否与预期匹配。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。