Dropbox

🚀 dbx-mcp-server

dbx-mcp-server 是一個與 Dropbox 集成的模型上下文協議（MCP）服務器。藉助一系列強大工具，它能讓 MCP 兼容客戶端通過 Dropbox 公開 API 進行交互。

⚠️ 重要聲明

該項目未得到、獲得或由 Dropbox 贊助，是一個獨立的集成項目，通過 Dropbox 的公共 API 開展工作。

🚀 快速開始

1. 克隆倉庫。
2. 運行 npm install 安裝依賴項。
3. 運行 npm run build 構建項目。
4. 在Dropbox應用控制檯註冊一個 Dropbox 應用：
   • 選擇“範圍訪問”API。
   • 選擇您的應用所需的訪問類型。
   • 命名您的應用並點擊“繼續”。
   • 添加回調 URL（例如：http://localhost:3000/callback）。
5. 獲取生成的應用密鑰和秘密，並將它們添加到 dropbox.json 文件中：

   {
     "DROPBOX_APP_KEY": "your-app-key",
     "DROPBOX_APP_SECRET": "your-app-secret"
   }
   

6. 安裝並運行 MCP 代理以開始使用。

📦 安裝指南

git clone [倉庫地址]
cd dbx-mcp-server
npm install

✨ 主要特性

• 簡化了與 Dropbox API 的交互。
• 提供統一的身份驗證流。
• 支持多種用戶身份驗證方法。

🔐 身份驗證

該服務器使用OAuth 2.0標準進行身份驗證，具體實現採用AUTHORIZATION_CODE授予類型。支持的範圍包括文件和目錄訪問權限。

💻 可用工具

文件操作

// 上傳文件
async function uploadFile(filePath: string, content: Buffer): Promise<void> {
  const dbx = new DropboxClient();
  await dbx.files.upload(filePath, content);
}

// 下載文件
async function downloadFile(filePath: string): Promise<Buffer> {
  const dbx = new DropboxClient();
  return await dbx.files.download(filePath);
}

目錄管理

// 創建目錄
async function createDirectory(directoryPath: string): Promise<void> {
  const dbx = new DropboxClient();
  await dbx.files.createFolder(directoryPath);
}

// 刪除目錄
async function deleteDirectory(directoryPath: string): Promise<void> {
  const dbx = new DropboxClient();
  await dbx.files.deleteFolder(directoryPath);
}

文件共享

// 分享文件
async function shareFile(filePath: string): Promise<string> {
  const dbx = new DropboxClient();
  return await dbx.sharing.createShare(filePath);
}

// 恢復已分享的文件
async function restoreSharedFile(shareId: string): Promise<Buffer> {
  const dbx = new DropboxClient();
  return await dbx.sharing.revoke(shareId);
}

⚙️ 配置

環境變量

# 推薦設置
export DROPBOX_APP_KEY="your-app-key"
export DROPBOX_APP_SECRET="your-app-secret"

應用配置文件

創建 config.json 文件：

{
  "dropbox": {
    "appKey": "your-app-key",
    "appSecret": "your-app-secret"
  }
}

💻 使用示例

基礎用法

import { DropboxClient } from './dbx-mcp-server';

async function main() {
  const dbx = new DropboxClient();
  
  // 上傳本地文件
  await dbx.files.upload('/uploads/test.txt', fs.readFileSync('test.txt'));
  
  // 下載遠程文件
  const content = await dbx.files.download('/uploads/test.txt');
  console.log(content.toString());
}

main().catch(console.error);

高級用法

import { DropboxClient } from './dbx-mcp-server';

async function main() {
  const dbx = new DropboxClient();
  
  // 創建新目錄
  await dbx.files.createFolder('/my-new-folder');
  
  // 刪除目錄
  await dbx.files.deleteFolder('/my-empty-folder');
}

🧪 測試

快速運行測試

npm test

指定測試文件

npm test tests/dropbox/search-delete.test.ts

過濾測試描述

npm test -- -t "should search for files"

🛠️ 開發

該服務器使用以下技術構建：

• TypeScript
• MCP SDK
• Dropbox SDK v10.34.0
• API 版本：v2

📄 許可證

MIT License

版權 (c) 2025 MCP Server Contributors

允許任何人免費獲得和分發此軟件及其關聯的文檔文件（“軟件”），並且可以不受限制地進行研究、開發、測試、商業部署或銷售。

在以下條件下，您可以在任何情況下使用、複製、修改、合併、發佈、分發、 sublicense 和/或出售該軟件，並允許獲得該軟件的人對其進行操作：

1. 本版權聲明和此許可聲明必須包含在所有副本或該軟件的實質性部分中。
2. 本軟件按“原樣”提供，不附帶任何明示或暗示的保證。包括但不限於對適銷性、適用性和非侵權性的保證。

貢獻者

• [你的名字] - 初始實現
• [其他貢獻者]