DBX MCP Server

🚀 dbx-mcp-server

dbx-mcp-server 是一個支持模型上下文協議（MCP）的服務器，它實現了與 Dropbox 的集成，讓 MCP 兼容客戶端能借助一組強大的工具與 Dropbox 進行交互。

⚠️ 重要提示

該項目未獲得 Dropbox 的任何關聯、認可或贊助，是一個獨立集成了 Dropbox 公共 API 的項目。

🚀 快速開始

1. 克隆倉庫
2. 安裝依賴項
3. 配置環境變量
4. 運行服務器

📦 安裝指南

要安裝 dbx-mcp-server，請按照以下步驟操作：

npm install dbx-mcp-server

或者使用 yarn：

yarn add dbx-mcp-server

🔐 身份驗證

基於 OAuth 的認證

1. 配置身份提供者（例如，Dropbox OAuth）
2. 實現 Authenticator 接口
3. 使用生成的訪問令牌進行身份驗證

基於密鑰的認證

使用以下環境變量配置基於密鑰的身份驗證：

DBX_APP_KEY=your_app_key
DBX_APP_SECRET=your_app_secret

✨ 主要特性

文件操作

• createFile(filePath: string, content: Buffer): Promise<void>
• readFile(filePath: string): Promise<Buffer>
• updateFile(filePath: string, content: Buffer): Promise<void>
• deleteFile(filePath: string): Promise<void>

目錄操作

• createDirectory(directoryPath: string): Promise<void>
• listDirectory(directoryPath: string): Promise<string[]>
• removeDirectory(directoryPath: string): Promise<void>

⚙️ 配置

修改 config.json 以自定義服務器行為：

{
  "port": 3000,
  "host": "localhost",
  "auth_provider": "dropbox"
}

💻 使用示例

基礎用法

// 示例1：創建文件
import { Dropbox } from 'dbx-mcp-server';

async function main() {
    const dbx = new Dropbox({
        accessToken: 'your_access_token'
    });
    
    await dbx.createFile('test.txt', Buffer.from('Hello, World!'));
    console.log('文件創建成功');
}

main();

高級用法

// 示例2：讀取文件
import { Dropbox } from 'dbx-mcp-server';

async function main() {
    const dbx = new Dropbox({
        accessToken: 'your_access_token'
    });
    
    const content = await dbx.readFile('test.txt');
    console.log(content.toString());
}

main();

🧪 測試

運行測試

使用以下命令運行所有測試：

npm test

或者指定特定測試文件：

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

指定測試描述

運行匹配特定描述的測試：

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

💻 開發

該項目使用以下技術棧構建：

• TypeScript
• Model Context Protocol SDK
• Dropbox SDK v10.34.0
• Dropbox API v2

📄 許可證

MIT License

版權 (c) 2025 MCP Server Contributors

准許任何人獲取本軟件及其相關文檔文件（“軟件”），並免費進行處理，包括但不僅限於以下權利：使用、複製、修改、合併、發佈、分發、 sublicense 和/或出售軟件副本，以及允許獲得軟件的人對其進行處理。在上述條件下，本聲明應包含在所有副本或軟件的實質性部分中。

軟件按“現狀”提供，不做任何明示或暗示的擔保，包括但不僅限於對適銷性、特定用途適用性及無侵權的擔保。無論是在合同行為、侵權行為或其他行為中，作者或版權持有者均不對任何聲明、損害賠償或其他責任負責，無論是附帶的還是直接的。