Dropbox

🚀 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

🔐 認証

このサーバーは、OAuth 2.0標準を使用して認証を行います。具体的には、AUTHORIZATION_CODEグラントタイプを採用しています。サポートされるスコープには、ファイルおよびディレクトリへのアクセス権が含まれます。

✨ 主な機能

• Dropbox APIとのやり取りを簡素化します。
• 統一された認証フローを提供します。
• 複数のユーザー認証方法をサポートします。

💻 利用可能なツール

ファイル操作

// ファイルをアップロードする
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ライセンス

Copyright (c) 2025 MCP Server Contributors

誰でもこのソフトウェアとその関連するドキュメントファイル（「ソフトウェア」）を無料で取得し、配布することができます。また、研究、開発、テスト、商用デプロイ、または販売を制限なく行うことができます。

以下の条件の下で、このソフトウェアを使用、複製、変更、統合、公開、配布、サブライセンス、および/または販売することができ、このソフトウェアを取得した人に対しても同様の操作を許可することができます。

1. この著作権表示とこのライセンス表示は、すべてのコピーまたはこのソフトウェアの実質的な部分に含まれていなければなりません。
2. このソフトウェアは「現状のまま」提供され、明示的または暗示的な保証を一切伴いません。これには、商品性、特定の目的への適合性、および非侵害性に関する保証が含まれますが、これらに限定されません。

貢献者

• [あなたの名前] - 初期実装
• [その他の貢献者]