Box Community MCP Server Box

🚀 MCP Server Box

MCP Server BoxはPythonプロジェクトで、Box APIと統合して、ファイル検索、テキスト抽出、AIベースのクエリ、データ抽出などの様々な操作を実行します。このプロジェクトはbox-sdk-genライブラリを利用し、Boxのファイルとフォルダを対話的に処理する一連のツールを提供します。

モデルコンテキストプロトコル（MCP）は、モデルと複数のデータソースおよびサービス間の相互作用方法を標準化するためのフレームワークです。このプロジェクトでは、MCPを使用してBox APIとのシームレスな統合を促進し、Boxのファイルとフォルダに対する効率的かつ拡張可能な操作を実現します。MCP Server Boxプロジェクトは、高度なAIと機械学習技術を使用してBoxデータを管理および処理するための強力かつ柔軟なソリューションを提供することを目的としています。

✨ 主な機能

実装されたツール

box_who_am_i

現在のユーザー情報を取得し、接続状態を確認します。

戻り値: ユーザー情報の文字列

box_authorize_app_tool

Boxアプリの認証プロセスを開始します。

戻り値: 認証状態のメッセージ

box_search_tool

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

パラメータ:

• query (str): 検索クエリ
• file_extensions (List[str], オプション): フィルタリングするファイル拡張子
• where_to_look_for_query (List[str], オプション): 検索位置（NAME, DESCRIPTION, FILE_CONTENT, COMMENTS, TAG）
• ancestor_folder_ids (List[str], オプション): 検索対象のフォルダID

戻り値: 検索結果

box_read_tool

Boxファイルのテキスト内容を読み取ります。

パラメータ:

• file_id (str): 読み取るファイルのID

戻り値: ファイル内容

box_ask_ai_tool

Box AIにファイルに関する質問をします。

パラメータ:

• file_id (str): ファイルID
• prompt (str): AIに投げる質問

戻り値: AIの応答

box_search_folder_by_name

名前でフォルダを検索します。

パラメータ:

• folder_name (str): フォルダ名

戻り値: フォルダID

box_ai_extract_data

AIを使用してファイルからデータを抽出します。

パラメータ:

• file_id (str): ファイルID
• fields (str): 抽出するフィールド

戻り値: JSON形式の抽出データ

box_list_folder_content_by_folder_id

フォルダの内容を一覧表示します。

パラメータ:

• folder_id (str): フォルダID
• is_recursive (bool): 再帰的に一覧表示するかどうか

戻り値: id、名前、タイプ、説明を含むJSON形式のフォルダ内容

📦 インストール

前提条件

• Python 3.13以上
• Box APIの認証情報（クライアントID、クライアントシークレットなど）

手順

1. リポジトリをクローンします:

git clone https://github.com/box-community/mcp-server-box.git
cd mcp-server-box

2. まだインストールされていない場合は、uvをインストールします。
   • MacOS+Linux

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   • Windows

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

3. プロジェクトを作成して設定します。
   • MacOS+Linux

   # 仮想環境を作成してアクティブ化する
   uv venv
   source .venv/bin/activate
   
   # 依存関係をロックする
   uv lock
   

   • Windows

   # 仮想環境を作成してアクティブ化する
   uv venv
   .venv\Scripts\activate
   
   # 依存関係をロックする
   uv lock
   

4. プロジェクトのルートディレクトリに.envファイルを作成し、Box APIの認証情報を追加します。

BOX_CLIENT_ID=your_client_id
BOX_CLIENT_SECRET=your_client_secret

💻 使用例

MCPサーバーの起動

MCPサーバーを起動するには、以下のコマンドを実行します。

uv --directory /path-to-the-project/mcp-server-box run src/mcp_server_box.py

Claudeをクライアントとして使用する

1. claude_desktop_config.jsonファイルを編集します。

code ~/Library/Application\ Support/Claude/cla

（注：元のREADMEでこのコマンドの続きが途中で切れていますが、そのまま出力しています。）