CLIO Parquet

社区

Apache Parquet 文件的模型上下文协议服务器

分类: 文件系统第 14 / 24
Stars: ★ 30 热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · 预编译二进制
凭据: 无需凭据
许可证: BSD-3-Clause
最近提交: 2 个月前
工具数: 4

55FMRS · C

CLIO Parquet 是一个专门的 MCP 服务器，用于读取 Apache Parquet 文件。它提供基本的工具，用于摘要、行读取、列预览和聚合统计。它是 CLIO Kit 生态的一部分，支持科学和高性能计算场景。其功能清晰，但深度有限；对于仅为摘要和读取而设计的目标用户而言，它很适合，但可能无法涵盖复杂完整的数据分析需求。

最强项 · 维护活跃度 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

13/20

文档质量

10/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 清单中工具定义清晰（summarize/read_slice/column_preview/aggregate），与parquet语义一致，包参数（mcp-server parquet）合理。但未提供parquet服务器的已提交测试、真实tools/list输出或执行证据；README展示的合同工件仅覆盖JARVIS/SLURM/Spack/Scientific Catalog，不含parquet；清单版本2.2.3与PyPI包版本2.10.6不一致，削弱版本可追溯性。静态审查下不能给高分。
安全与权限 12/20: 工具均为本地Parquet文件的只读分析（读schema、行切片、列预览、聚合），stdio传输，无网络调用、凭据处理或危险副作用，未见红线问题。但未提供源码证明输入路径校验、错误处理与数据边界，权限与数据流披露不完整，无法给更高分。
维护活跃度 13/20: 仓库未归档，BSD-3-Clause许可证明确，有CI、coverage、pip-audit徽章，NSF资助、GRC/IIT团队署名，社区渠道（Zulip、Issues、Discussions）齐全，PyPI有活跃发布。但版本号在清单、README表格与PyPI之间互相矛盾（2.2.3 vs 2.10.6 vs 2.4.3），治理与版本管理存在明显缺口，且无法确认parquet子服务器的具体维护节奏。
文档质量 10/20: README提供了整体安装、多客户端配置示例和troubleshooting章节，parquet在服务器表格中有一行说明。但parquet四个工具的参数、返回格式、限制、过滤语法均未记录，也没有该服务器的独立README或用例示例，属于可用但隐藏假设较多。
安装易用性 12/20: 安装路径清晰：uv tool install clio-kit 后运行 clio-kit mcp-server parquet，manifest含registryType/identifier/positional参数可供客户端直接引用，客户端JSON示例可平移。但README的客户端示例未包含parquet，且wheel通过嵌入式uv.lock启动、文档中安装版本号（2.4.3）与其他处版本不一致，增加手动排错风险，故不超静态上限。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件

适合谁

科学计算与高性能计算环境中的数据探索。
需要从 Parquet 文件快速获取摘要信息的 AI 代理。
与 CLIO Kit 集成的工作流，其中其他服务器提供互补功能。

不适合谁

需要复杂数据处理（如分组聚合）的全方位数据分析，这可能需要专用工具。
处理极大型文件时，所有数据可能无法完全加载到内存。

所需权限

读取用户提供的本地文件系统中的 Parquet 文件。
执行文件 I/O，以读取文件元数据和内容。

风险与副作用

如果输入包含意外文件路径，可能会暴露敏感数据。
通过大型文件或复杂查询进行的内存或计算密集型操作可能导致资源耗尽。

安装接入

准备工作

运行环境：Python 3.10+ · 预编译二进制

确保已安装 Python 3.10+ 和 uv（包管理器）。\n2. 使用 uv tool install 'clio-kit==2.10.6' 安装 clio-kit。\n3. 如果可执行文件不在 PATH 中，运行 uv tool update-shell。\n4. 验证服务器列表：clio-kit mcp-servers。\n5. 启动服务器：clio-kit mcp-server parquet。

验证是否装好

运行 `clio-kit mcp-server parquet` 启动服务器，在客户端工具列表中应出现 summarize_tool、read_slice_tool、get_column_preview_tool 和 aggregate_column_tool；对任意 Parquet 文件调用 summarize_tool 返回模式与行数即证明连接成功。

常见排障

如果服务器未找到，请验证服务器名称为 `parquet`（不是 `parquet-mcp`）。
如果出现导入错误，请在 `clio-kit-mcp-servers/parquet` 目录下运行 `uv sync --all-extras --dev` 进行本地开发。
如果命令 `clio-kit` 未找到，请安装 uv 并运行 `uv tool install 'clio-kit==2.10.6'`，然后使用 `uv tool update-shell` 更新 shell。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

总结这个 Parquet 文件的模式、行数和文件大小。
从这个 Parquet 文件读取第 0 到 100 行，只返回指定的几列。
分页预览 'temperature' 列的值。
计算这一列的最小值、最大值和平均值。

工具能力 4

summarize_tool 只读

返回 Parquet 文件的模式、行数和文件大小。

read_slice_tool 只读

从 Parquet 文件中读取行切片，支持列选择和过滤。

get_column_preview_tool 只读

预览特定列的值，支持分页。

aggregate_column_tool 只读

计算 Parquet 列上的聚合统计信息（最小值、最大值、平均值等）。

使用场景

快速获取 Parquet 文件的模式、行数和大小。

选择性地读取 Parquet 文件的行切片以进行数据检查。

预览指定列的值，便于初步了解数据。

在 Parquet 列上计算统计摘要，如均值或最大值。

支持客户端

Claude Desktop

Claude Code

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

CLIO Parquet 是 CLIO Kit（IoWarp 平台工具层的一部分）提供的 MCP 服务器，用于读取和分析 Apache Parquet 文件。它提供工具来获取模式摘要、读取行切片、预览列值以及计算列统计信息。此服务器通过 Python 包 clio-kit 分发，通过 stdio 通信。适合在本地或 HPC 环境中分析存储在 Parquet 格式中的科学或表格数据。

同仓库的其他 Server

源版本 93e41d70d6c2 数据同步于 2026-10-19 查看 FMRS 评分方法