dbx-mcp-server
2025.03.25
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 账户信息的应用。
工具列表
- 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，设置权限并创建应用。
-
如何配置环境变量？
-
需要设置
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"