Dbx MCP Server

🚀 dbx-mcp-server

dbx-mcp-server 是一個與 Dropbox 集成的模型上下文協議（MCP）服務器，它為兼容的客戶端提供了一組強大的工具，用於與 Dropbox 進行交互。

⚠️ 重要提示

該項目未得到官方認可、支持或贊助，它是一個獨立集成，通過使用 Dropbox 的公開 API 來實現功能。

🚀 快速開始

1. 克隆倉庫。
2. 運行npm install安裝依賴項。
3. 運行npm run build構建項目。
4. 在Dropbox應用控制檯註冊一個Dropbox應用：
   • 選擇“範圍訪問”API。
   • 選擇所需的應用訪問類型。
   • 命名你的應用並點擊“創建應用”。
   • 在“權限”部分，選擇所需的權限：
     • files.metadata.read
     • files.content.read
     • files.content.write
     • sharing.write
     • account_info.read
   • 添加http://localhost:3000/callback作為重定向URI。
   • 記錄你的應用密鑰和秘密密鑰。
5. 運行設置腳本：

   npm run setup
   

6. 配置MCP客戶端。

📦 安裝指南

本項目構建使用了以下技術：

• TypeScript
• 模型上下文協議SDK
• Dropbox SDK v10.34.0
• Dropbox API v2

🔐 身份驗證

應用通過OAuth 2.0與Dropbox進行通信，具體步驟如下：

初始化OAuth客戶端

const dbx = new DropboxClient({
  clientId: DROPBOX_CLIENT_ID,
  clientSecret: DROPBOX_CLIENT_SECRET,
  redirectUri: REDIRECT_URI
});

獲取授權URL

const authorizeUrl = await dbx.authorizeAsync();

處理回調並獲取訪問令牌

const { accessToken } = await dbx.getAccessToken(redirect_response);

🛠️ 可用工具

文件操作

• dbx.filesCreateV2/commit：創建新文件或覆蓋現有文件。
• dbx.filesReadV2/chunked：分塊讀取文件內容。
• dbx.filesDeleteV2/sync：同步刪除文件。
• dbx.delta.sync：獲取文件修改記錄。

目錄操作

• dbx.usersGetCurrentAccount：獲取當前用戶信息。
• dbx.groupsCreateSubgroup：創建子組。
• dbx.sharingShareFolder：共享文件夾。
• dbx.sharingRevokeAccess：撤銷訪問權限。

⚙️ 配置

環境變量

設置以下環境變量：

DROPBOX_CLIENT_ID=your_client_id
DROPBOX_CLIENT_SECRET=your_client_secret
REDIRECT_URI=http://localhost:3000/callback

代理配置

如果需要通過代理訪問Dropbox，請在初始化時添加代理信息：

const transport = newHttps.Agent({
   proxy: {
     host: 'proxy.example.com',
     port: 8080,
     credentials: {
       user: 'proxy-user',
       password: 'proxy-password'
     }
   }
});

const dbx = new DropboxClient({ 
   clientId: DROPBOX_CLIENT_ID,
   clientSecret: DROPBOX_CLIENT_SECRET,
   redirectUri: REDIRECT_URI,
   transport
});

💻 使用示例

基礎用法

// 上載文件
async function uploadFile(filePath, fileName) {
   const fileBuffer = await fs.readFile(filePath);
   const response = await dbx.filesCreateV2/commit({
     path: fileName,
     contents: { buffer: fileBuffer },
     mode: 'overwrite'
   });
   return response;
}

// 下載文件
async function downloadFile(filePath, fileName) {
   const response = await dbx.filesReadV2/chunked({ 
     path: filePath,
     maxBytes: 1024 * 1024 // 每次讀取1MB
   });
   return response;
}

🧪 測試

運行測試

使用Jest運行測試：

npm test

🛠️ 開發

項目使用了以下工具：

• TypeScript：定義文件類型並提供自動補全。
• @dropbox/dropbox-node-sdk：訪問Dropbox API的Node.js庫。
• Jest：用於單元測試和集成測試。
• ESLint：代碼規範檢查。
• Prettier：格式化代碼。

📄 許可證

本項目採用 MIT 許可證。

版權 (c) 2025 MCP Server 貢獻者

允許任何人免費獲得本軟件副本及相關文檔文件（“軟件”），不受限制地處理，包括但不限於以下權利：使用、複製、修改、合併、發佈、分發、轉授和/或出售軟件副本，並允許獲得該軟件的人進行上述行為，但需遵守以下條件：上述版權聲明和本許可聲明應包含在所有軟件副本或其中大部分內容中。

軟件按“原樣”提供，不做任何形式的擔保，包括但不限於對適銷性、特定用途適用性或不侵權的明示或暗示保證。在任何情況下，作者或版權持有者不對因使用或無法使用該軟件而產生的任何索賠、損害或其他責任負責。