Hmk Box MCP Server

🚀 使用說明

本項目提供了一個MCP服務器，支持搜索和讀取文件等功能。下面將詳細介紹開發者令牌授權、Claude Desktop配置、功能概述以及開發環境的設置。

🚀 快速開始

開發者令牌授權

目前，此MCP服務器僅支持開發者令牌認證。你需要將BOX_DEV_TOKEN設置為Box開發者令牌。具體步驟如下：

1. 訪問Box開發者控制檯，創建一個新的應用。授權類型目前無關緊要，因為所有支持Box開發者令牌的應用都可以使用。
2. 應用程序創建完成後，導航到其配置設置並點擊生成開發者令牌。

Claude Desktop配置

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": [
        "box-mcp-server"
      ],
      "env": {
        "BOX_DEV_TOKEN": "在此處放置你的開發者令牌"
      }
    }
  }
}

✨ 主要特性

1. 搜索文件：可在系統中搜索所需文件。
2. 讀取文件：支持讀取PDF和Word文件，其他文件類型暫不支持。
   • [x] PDF
   • [x] Word
   • [ ] 其他

📦 安裝指南

先決條件

在開始之前，請確保安裝了以下內容：

• 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。