XRootD MCP Server

XRootD MCP服务器

一种模型上下文协议（MCP）服务器，提供对XRootD文件系统的访问。此服务器允许LLM与XRootD服务器交互，以列出目录、读取文件元数据、访问文件内容等。

📚 查看完整文档

特性

• 列出目录：浏览XRootD文件系统层次结构
• 文件元数据：获取有关文件的详细信息（大小、修改时间、权限）
• 读取文件内容：从支持字节范围的XRootD服务器访问文件数据
• 文件 操作：检查文件是否存在，计算目录大小
• 搜索和筛选：按模式（glob/regex）查找文件，按大小/日期过滤
• 统计与分析：全面的目录统计和使用情况报告
• 活动发现：列出可用的生产活动和数据集
• 最近的更改：跟踪新添加的文件并监控生产进度
• ROOT文件分析：检查ROOT文件结构，提取元数据，分析事件和集合
• 数据集聚合：跨多个ROOT文件聚合事件统计信息
• 协议支持：通过root://协议连接到XRootD服务器

安装

使用Docker（推荐）

docker pull ghcr.io/eic/xrootd-mcp-server:latest

docker run -i --rm \
  -e XROOTD_SERVER="root://dtn-eic.jlab.org" \
  -e XROOTD_BASE_DIR="/volatile/eic/EPIC" \
  ghcr.io/eic/xrootd-mcp-server:latest

看 详细说明。

来源

npm install
npm run build

配置

使用设置XRootD服务器URL XROOTD_SERVER 环境变量：

export XROOTD_SERVER="root://dtn-eic.jlab.org"

（可选）设置一个基本目录以限制访问并简化路径：

export XROOTD_BASE_DIR="/volatile/eic/EPIC"

当 XROOTD_BASE_DIR 已设置：

• 相对路径是相对于基目录解析的
• 绝对路径必须在基目录内（访问控制）
• 例如，对于base /volatile/eic/EPIC，路径 EVGEN 指的是 /volatile/eic/EPIC/EVGEN

缓存

缓存目录列表结果以提高性能：

export XROOTD_CACHE_ENABLED=true      # default: true
export XROOTD_CACHE_TTL=60            # minutes, default: 60
export XROOTD_CACHE_MAX_SIZE=1000     # max entries, default: 1000

缓存使用基于时间的过期策略（TTL）：

• 目录列表缓存在内存中
• 缓存条目在配置的TTL之后过期
• 自动清理每15分钟删除一次过期条目
• 当缓存大小超过1000个条目时，LRU被驱逐

注： 缓存的数据可能长达TTL分钟。对于不经常更改的生产数据，60分钟的TTL提供了良好的性能和可接受的过时性。

用法

使用MCP客户端

添加到MCP客户端配置中：

{
  "mcpServers": {
    "xrootd": {
      "command": "node",
      "args": ["/path/to/xrootd-mcp-server/build/index.js"],
      "env": {
        "XROOTD_SERVER": "root://dtn-eic.jlab.org",
        "XROOTD_BASE_DIR": "/volatile/eic/EPIC",
        "XROOTD_CACHE_ENABLED": "true",
        "XROOTD_CACHE_TTL": "60"
      }
    }
  }
}

可用工具

基本文件操作：

• list_directory：列出XRootD目录的内容
• get_file_info：获取有关文件的详细元数据
• read_file：读取文件内容（可选字节范围）
• check_file_exists：检查文件或目录是否存在
• get_directory_size：计算目录的总大小

高级搜索和分析：

• search_files：按glob模式或正则表达式搜索文件
• list_directory_filtered：使用高级筛选（大小、日期、扩展名、模式）列出目录
• find_recent_files：查找在一段时间内修改的文件
• get_statistics：获取目录中文件的全面统计信息

活动和数据集发现：

• list_campaigns：列出可用的生产活动
• list_datasets：列出特定活动中的数据集
• summarize_recent_changes：用详细统计数据汇总一段时间内添加的文件

发展

# Build
npm run build

# Watch mode
npm run watch

需求

• Node.js 18或更高版本
• 访问XRootD服务器
• 已安装xrdfs命令行工具（来自xrootd客户端包）

许可证

麻省理工学院