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ライセンス

Copyright (c) 2025 MCP Server Contributors

本ソフトウェアおよび関連ドキュメントファイル（「ソフトウェア」）のコピーを取得するすべての人に対して、無料でソフトウェアを取り扱うことを許可します。これには、使用、コピー、変更、結合、公開、配布、サブライセンス、および/またはソフトウェアのコピーを販売する権利が含まれます。ただし、上記の条件の下で、この声明はすべてのコピーまたはソフトウェアの実質的な部分に含まれる必要があります。

ソフトウェアは「現状のまま」提供され、商品性、特定の目的への適合性、および非侵害に関する明示または黙示の保証を含む、いかなる保証も行われません。契約行為、不法行為、またはその他の行為において、作者または著作権所有者は、いかなる声明、損害賠償、またはその他の責任についても、間接的または直接的に責任を負いません。