MCP Server Box

🚀 MCP サーバーボックスの日本語翻訳

MCP サーバーボックスは Python ベースのプロジェクトで、Box API との統合を目的としています。このプロジェクトは、ファイル検索、テキスト抽出、AI 駆動の機能、およびファイルのアップロードとダウンロードなど、様々な機能を提供します。

✨ 主な機能

コアコンポーネント

• Box API 統合: box-sdk-gen ライブラリを使用して、Box クラウドストレージサービスとのやり取りを実現します。
• MCP フレームワーク: モデルコンテキストプロトコル（Model Context Protocol）に基づいており、異なるモジュール間の通信を管理および調整します。
• 機能特性：
  • ファイル検索
  • テキスト抽出
  • AI 駆動の機能
  • ファイルのアップロードとダウンロード

📦 インストール

システム要件

• オペレーティングシステム: MacOS/Linux または Windows をサポート
• メモリ: 少なくとも 2GB RAM を推奨
• その他: Python と pip をインストールする必要があります

インストール手順

1. リポジトリをクローンする

   git clone https://github.com/your-repository-url/mcp-server-box.git
   cd mcp-server-box
   

2. uv ツールをインストールする

   # uv をグローバルにインストール
   pip install uv
   
   # 仮想環境を作成してアクティブ化（MacOS/Linux）
   uv venv
   source .venv/bin/activate
   
   # 仮想環境を作成してアクティブ化（Windows）
   uv venv
   ./.venv/Scripts/activate
   

3. 依存関係をロックする

   # プロジェクトの依存関係をロック
   uv lock
   
   # 依存関係を virtualenv にインストール
   pip install -r requirements.txt
   

4. 環境変数を設定する .env ファイルを作成し、以下の内容を追加します。

   BOX_CLIENT_ID=あなたのクライアント ID
   BOX_CLIENT_SECRET=あなたのクライアントシークレット
   

💻 使用例

サーバーの起動

MCP サーバーを起動する

uv --directory /Users/your-username/Desktop/mcp-server-box run src/mcp_server_box.py

Claude クライアントを設定する（オプション）

1. Claude の設定ファイルを開く：

   code ~/Library/Application\ 支持/Claude/claude_desktop_config.json
   

2. mcpServers ノードに以下の内容を追加する：

   {
       "mcp-server-box": {
           "command": "uv",
           "args": [
               "--directory",
               "/Users/your-username/Desktop/mcp-server-box",
               "run",
               "src/mcp_server_box.py"
           ]
       }
   }
   

3. Claude アプリケーションを再起動する。

テストケースの実行

テスト環境の準備

1. ファイルとフォルダの ID を更新する：

   • tests/ ディレクトリ内の各テストファイルで、すべてのハードコードされた Box ファイルとフォルダの ID を置き換えます。
   • 例: test_box_api_read.py で、"1728677291168" をあなたの Box アカウント内の有効なファイル ID に置き換えます。

2. テストケースの説明：

   • test_box_auth.py: 認証機能を検証します。
   • test_box_api_basic.py: 基本的な Box API 機能をテストします。
   • test_box_api_read.py: ファイル読み取り機能をテストします。
   • test_box_api_search.py: 検索機能をテストします。
   • test_box_api_ai.py: AI 駆動の機能をテストします。
   • test_box_api_file_ops.py: ファイルのアップロードとダウンロード操作をテストします。

テストの実行

# すべてのテストを実行
pytest

# 特定のテストファイルを実行
pytest tests/test_box_api_file_ops.py

# 詳細モードでテストを実行
pytest -v

# 印刷出力を表示してテストを実行
pytest -v -s

🔧 トラブルシューティング

一般的な問題

• 依存関係がインストールされていない: すべてのプロジェクト依存関係が正しくインストールされていることを確認してください。
• 環境変数の設定が間違っている: .env ファイル内の BOX_CLIENT_ID と BOX_CLIENT_SECRET が正しいことを確認してください。
• 権限の問題: あなたの Box アカウントがテストファイルにアクセスするのに十分な権限を持っていることを確認してください。

解決策

1. プロジェクトの依存関係を再インストールする：

   pip install -r requirements.txt
   

2. 環境変数を検証する：

   echo $BOX_CLIENT_ID
   echo $BOX_CLIENT_SECRET
   

3. Box アカウントの権限を確認し、テストファイル内の ID を更新します。

その他のリソース

• Box Developer Documentation
• uv ツールのドキュメント
• Python 公式ドキュメント