cindyloo-dropbox-mcp-server

Dropbox MCP サーバー

高度な検索機能とコンテンツ抽出機能を備え、Dropbox ファイルへの読み取りアクセスを提供する Model Context Protocol（MCP）サーバーです。

機能

• ファイル一覧：Dropbox 内のファイルやフォルダーを参照します
• ファイルの読み取り：さまざまなファイル形式（PDF、DOCX、TXT、コードファイル）の内容を読み取ります
• 検索：Dropbox 内のファイル名を検索します
• コンテンツ検索：ファイル内の特定のテキストを検索します
• ファイル情報：ファイルの詳細なメタデータを取得します
• スマートテキスト抽出：PDF および DOCX ファイルからテキストを自動抽出します

対応ファイル形式

• PDF - PyPDF2 によるテキスト抽出
• DOCX/DOC - ドキュメントのテキスト抽出
• テキストファイル - TXT、MD、PY、JS、HTML、CSS、JSON、CSV

インストール

前提条件

• Python 3.10 以上
• Dropbox アカウントとアクセストークン

Dropbox アクセストークンの取得

1. Dropbox App Console にアクセスします
2. 「Create app」をクリックします
3. 「Scoped access」と「Full Dropbox」アクセスを選択します
4. アプリに名前を付けます
5. 「Permissions」タブに移動して、以下を有効にします：
   • files.metadata.read
   • files.content.read
6. 「Settings」タブに移動して、アクセストークンを生成します

依存関係のインストール

pip install -e .

または手動でインストールします：

pip install mcp dropbox pydantic PyPDF2 python-docx

設定

Dropbox アクセストークンを環境変数として設定します：

export DROPBOX_ACCESS_TOKEN="your_access_token_here"

Claude Desktop の場合

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "dropbox": {
      "command": "python",
      "args": ["/path/to/your/dropbox_server.py"],
      "env": {
        "DROPBOX_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

Smithery の場合

デプロイ時、サーバーは DROPBOX_ACCESS_TOKEN 環境変数を自動的に使用します。

利用可能なツール

list_files

Dropbox ディレクトリ内のファイルとフォルダーを一覧表示します。

パラメーター：

• folder_path（任意）：フォルダーのパス（ルートの場合は空）
• max_files（任意）：返すアイテムの最大数（デフォルト：20）

search_files

ファイル名でファイルを検索します。

パラメーター：

• query：検索クエリ
• file_types（任意）：検索するファイル形式（「all」、「pdf」、「docx」、「txt」、またはカンマ区切り）
• max_results（任意）：結果の最大数（デフォルト：10）

read_file

ファイルの全内容を読み取ります。

パラメーター：

• file_path：ファイルのフルパス
• max_length（任意）：返す最大文字数（デフォルト：5000、0 の場合は無制限）

get_file_info

ファイルの詳細なメタデータを取得します。

パラメーター：

• file_path：ファイルのフルパス

search_file_content

特定のファイル内のテキストを検索します。

パラメーター：

• file_paths：検索するファイルパスのリスト
• query：検索するテキスト
• context_chars（任意）：一致箇所の前後に含めるコンテキストの文字数（デフォルト：100）

使用例

ルートディレクトリ内のファイルを一覧表示

list_files()

PDF ファイルを検索

search_files(query="invoice", file_types="pdf", max_results=5)

特定のファイルを読み取る

read_file(file_path="/documents/report.pdf")

ファイル内を検索

search_file_content(
    file_paths=["/documents/file1.txt", "/documents/file2.pdf"],
    query="important keyword"
)

開発

ローカルでの実行

python dropbox_server.py

テスト

DROPBOX_ACCESS_TOKEN が設定されていることを確認し、サーバーを実行して MCP クライアントでテストします。

セキュリティに関する注意

• Dropbox アクセストークンを安全に保管し、バージョン管理に絶対にコミットしないでください
• 環境変数または安全なシークレット管理を使用してください
• このサーバーが提供するのは Dropbox ファイルへの読み取りアクセスのみです
• 権限を最小限にしたアプリスコープのトークンの使用を検討してください

ライセンス

MIT License - 必要に応じて自由に使用、変更できます。

コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送信してください。

サポート

問題や質問がある場合は、GitHub で issue を作成してください。