MCP 服务器

MCP Server Box

镜子 (jìng zi)

MCP-Mirror

开发者工具

访问服务器

README

MCP 服务器盒子

描述

MCP 服务器盒子是一个 Python 项目，它与 Box API 集成，以执行各种操作，例如文件搜索、文本提取、基于 AI 的查询和数据提取。它利用 box-sdk-gen 库，并提供一组工具来与 Box 文件和文件夹进行交互。

模型上下文协议 (MCP) 是一个框架，旨在标准化模型与各种数据源和服务交互的方式。在此项目中，MCP 用于促进与 Box API 的无缝集成，从而实现对 Box 文件和文件夹的高效且可扩展的操作。 MCP 服务器盒子项目旨在提供一个强大而灵活的解决方案，用于使用先进的 AI 和机器学习技术来管理和处理 Box 数据。

已实现的工具

Box 工具

`box_who_am_i`

获取您当前的用户信息并检查连接状态。

返回： 用户信息字符串

`box_authorize_app_tool`

启动 Box 应用程序授权过程。

返回： 授权状态消息

`box_search_tool`

在 Box 中搜索文件。

参数：

query (str)：搜索查询
file_extensions (List[str], optional)：要按其进行过滤的文件扩展名
where_to_look_for_query (List[str], optional)：搜索位置（NAME、DESCRIPTION、FILE_CONTENT、COMMENTS、TAG）
ancestor_folder_ids (List[str], optional)：要在其中搜索的文件夹 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)：是否递归列出

返回： JSON 格式的文件夹内容，包含 id、name、type 和 description

要求

Python 3.13 或更高版本
Box API 凭据（客户端 ID、客户端密钥等）

安装

克隆存储库：

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

如果尚未安装，请安装 uv：

2.1 MacOS+Linux

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

2.2 Windows

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

创建并设置我们的项目：

3.1 MacOS+Linux

# 创建虚拟环境并激活它
uv venv
source .venv/bin/activate

# 锁定依赖项
uv lock

3.1 Windows

# 创建虚拟环境并激活它
uv venv
.venv\Scripts\activate

# 锁定依赖项
uv lock

在根目录中创建一个 .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 作为客户端

编辑您的 claude_desktop_config.json

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

并添加以下内容：

{
    "mcpServers": {
        "mcp-server-box": {
            "command": "uv",
            "args": [
                "--directory",
                "/path-to-your-project/mcp-server-box",
                "run",
                "src/mcp_server_box.py"
            ]
        }
    }
}