Box MCP Server

🚀 box-mcp-server

box-mcp-serverは、Boxとの接続や操作を行うためのサーバーです。環境変数を設定することで、Boxとの認証や操作を行うことができます。

🚀 クイックスタート

使用方法

以下の環境変数が必要です。

• BOX_USER_ID

また、以下のいずれかの環境変数を設定する必要があります。

• BOX_JWT_BASE64（推奨）
• BOX_JWT_CONFIG_PATH
• BOX_JWT

✨ 主な機能

1. ファイルの検索
2. ファイルの読み取り
   • [x] PDF
   • [x] Word
   • [ ] その他

📦 インストール

開発環境のセットアップ

開発を始める前に、以下のソフトウェアをインストールしてください。

• Node.js（推奨 v22 以上）
• npm
• git
• dotenv

以下の手順で開発環境をセットアップします。

1. リポジトリをフォークする
   • このリポジトリの右上にある「フォーク」ボタンをクリックします。
   • これにより、あなたのGitHubアカウントにリポジトリのコピーが作成されます。
2. コピーをクローンする

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

3. 上流のリモートリポジトリを追加する

   git remote add upstream https://github.com/hmk/box-mcp-server.git
   

4. dotenvファイルをコピーする

   cp .env.template .env
   

5. 依存関係をインストールする

   npm install
   

6. ウォッチドッグを実行してindex.jsを更新する

   npm run watch
   

7. モデルコンテキストプロトコル開発サーバーを起動する

   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
   

8. 開発サーバーが環境変数を正しく読み込めない場合は、mcpインスペクターの左側でBOX_DEV_TOKENを設定してください。

🔧 技術詳細

認証

JSON Web Token (JWT) 認証（推奨）

JWTを使用すると、Boxとの永続的な接続を実現できます。

有料のBoxエンタープライズアカウントが必要です。または、無料の開発者アカウントを登録することもできます（リンクをクリックする前にBoxからログアウトしてください）。Box開発者コンソールにアクセスし、新しいアプリケーションを作成します。設定がまだの場合は、二段階認証を設定し、Boxアカウントでアプリを管理者として承認してください。以下が必要です。

1. アプリケーションにApp + エンタープライズアクセス権限を付与する
2. as-userヘッダーを使用したAPI呼び出しオプションを有効にする

Boxアプリの設定ページから行います。これらの設定を変更した場合は、必ずアプリを再承認してください。

JWTをBase64エンコードする

JWTをBase64エンコードするには、ターミナルで以下のコマンドを実行します。

cat /path/to/your/box-jwt-config.json | base64

/path/to/your/box-jwt-config.jsonを実際のJWT設定ファイルのパスに置き換えてください。これにより、Base64エンコードされたJWTが出力され、環境変数として使用できます。

Claude Desktopの設定

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_JWT_BASE64": "YOUR_BASE64_ENCODED_JWT",
        "BOX_USER_ID": "123456"
      }
    }
  }
}

開発者トークン認証（最も簡単）

開発者トークンを使用すると、Boxとの統合が最も簡単になりますが、有効期限は60分のみです。

始めるには、BOX_DEV_TOKENをBox開発者トークンに設定します。

まず、Box開発者コンソールにアクセスし、新しいアプリケーションを作成します。このとき、認証タイプは重要ではありません。Box開発者トークンをサポートするすべてのアプリケーションがサポートされます。

アプリケーションを作成したら、設定ページに移動し、開発者トークンを生成をクリックします。

Claude Desktopの設定

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_DEV_TOKEN": "YOUR_DEV_TOKEN_GOES_HERE"
      }
    }
  }
}