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と通信します。手順は以下の通りです。

1. OAuthクライアントを初期化します。

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

2. 承認URLを取得します。

   const authorizeUrl = await dbx.authorizeAsync();
   

3. コールバックを処理し、アクセストークンを取得します。

   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ライセンスの下で公開されています。

Copyright (c) 2025 MCP Server 貢献者

このソフトウェアおよび関連ドキュメントファイル（「ソフトウェア」）のコピーを無料で取得し、以下の権利を含む制限なく取り扱うことが許可されます。

使用、コピー、修正、統合、公開、配布、再ライセンス付与、および/または販売 ソフトウェアのコピーを取得した者に対しても同様の行為を許可しますが、以下の条件を満たす必要があります。

上記の著作権表示とこの許諾表示は、すべてのソフトウェアのコピーまたはその大部分に含まれる必要があります。

ソフトウェアは「現状のまま」提供され、適銷性、特定の用途への適合性、または非侵害性に関する明示または黙示の保証を含む、いかなる形式の保証も提供されません。いかなる場合も、作者または著作権者は、ソフトウェアの使用または使用不能に起因するいかなる請求、損害、またはその他の責任についても責任を負いません。