Hmk Box MCP Server

🚀 クイックスタート

このドキュメントでは、Box MCPサーバーの使用方法、機能、開発環境のセットアップについて説明します。

✨ 主な機能

• ファイル検索：システム内でファイルを検索できます。
• ファイル読み取り：PDFとWordファイルの読み取りに対応しています。

📦 インストール

開発者トークンの認証

現在、このMCPサーバーは開発者トークン認証のみをサポートしています。

始めるには、BOX_DEV_TOKENをBox開発者トークンに設定してください。

1. Box開発者コンソールにアクセスし、新しいアプリケーションを作成します。現在、認証タイプは重要ではありません。Box開発者トークンをサポートするすべてのアプリケーションを使用できます。
2. アプリケーションが作成されたら、その設定に移動し、開発者トークンを生成をクリックします。

Claude Desktopの設定

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": [
        "box-mcp-server"
      ],
      "env": {
        "BOX_DEV_TOKEN": "ここに開発者トークンを入力してください"
      }
    }
  }
}

開発環境のセットアップ

前提条件

開発を開始する前に、以下のソフトウェアがインストールされていることを確認してください。

• Node.js（v22以上）
• npm
• git

手順

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. 依存関係をインストールします。

   npm install
   

5. BOX_DEV_TOKEN環境変数を設定します。

   export BOX_DEV_TOKEN=your_developer_token
   

6. index.jsを更新するために監視を実行します。

   npm run watch
   

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

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

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