← 返回目录
H

HDF5 MCP Server

社区
面向 AI 智能体的科学数据访问工具,支持 HDF5 文件操作与 AI 洞察。
分类
文件系统 第 6 / 24
Stars
★ 30 热门
传输方式
stdio(本地进程)
运行环境
Python 3.10+ · 预编译二进制
凭据
无需凭据
许可证
BSD-3-Clause
最近提交
工具数
27
63FMRS · C

该服务器为 AI 智能体提供了全面的 HDF5 数据访问工具,特别适合科学计算场景。经过验证,工具描述与实际功能一致,但官方状态需进一步确认。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 10/20

可靠性
10/20
安全与权限
13/20
维护活跃度
14/20
文档质量
12/20
安装易用性
14/20
查看各项评分依据
可靠性 10/20
静态审查无法验证 hdf5 服务器实际可启动并通过握手;manifest 声明 27 个工具、3 个资源模板和 4 个 prompt,描述结构清晰,但未提交该服务器专属的测试或运行证据,仓库仅显示 CI/coverage 徽章(属仓库级、非服务器级证据)。此外版本信息不一致:manifest 服务器版本 2.2.3、PyPI 包版本 2.10.6、README 安装示例为 clio-kit==2.4.3,README 表格又称 27 个工具而 manifest 实际列出 27 项左右需人工核对,这种版本漂移降低可信度。扣分点:缺少可验证的执行/测试证据与版本一致性。
安全与权限 13/20
无红线风险:工具以读取/分析为主(open_file、read_*、list_*、stats 等),未发现恶意代码、凭据窃取或不可逆删除/部署默认值。但存在权限面问题:open_file/export_dataset 接受任意文件路径,未见路径沙箱、根目录约束或危险操作确认机制;export_dataset 与并行扫描的副作用(写出文件)未披露边界。扣分点:缺少最小权限与数据边界声明。
维护活跃度 14/20
仓库活跃(未归档,39 个 open issues,多徽章显示 CI/ruff/mypy/pip-audit),BSD-3-Clause 许可明确,由 IIT GRC 团队与 NSF 资助,有 Zulip/Issues 沟通渠道。但 manifest 服务器版本与包版本不一致暗示发布/版本治理不严谨;未见该服务器专属的依赖更新频率证据。扣分点:版本治理缺口与服务器级维护证据不足。
文档质量 12/20
README 层次较好:安装、多客户端(Cursor/Claude Code/VS Code/Claude Desktop)配置、故障排除、HDF5 使用示例齐全,并说明了 uv.lock 锁定机制。但清单中 27 个工具仅有简短描述,缺少参数、返回结构、限制(如大文件预览截断策略、export 支持格式清单)的文档;manifest 版本与 README 推荐安装版本不一致会误导用户。扣分点:工具参数级文档与限制披露不足。
安装易用性 14/20
安装路径清晰:uv tool install clio-kit 后一条命令 clio-kit mcp-server hdf5,stdio 传输,并提供四种主流客户端的完整 JSON 配置示例,兼容性说明(Python 3.10+,Linux/macOS/Windows 的 uv 安装)充分。扣分点:manifest 中 packageArguments 与 README 示例需人工核对一致,且无执行证据验证开箱即用,静态校准限制最高 15。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

  • 科研人员
  • 数据科学家
  • AI 智能体用于科学计算

不适合谁

  • 不需要 HDF5 文件的场景
  • 用户希望直接操作数据库或 CSV 文件

所需权限

  • 访问本地文件系统以读取 HDF5 文件
  • 可能生成临时文件或缓存数据
  • 网络访问(如果需要远程文件)

风险与副作用

  • 需要谨慎处理大型 HDF5 文件,防止内存不足
  • 并行操作可能导致 I/O 竞争

安装接入

准备工作

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

使用 pip 或 uv 工具安装 clio-kit 包,然后通过 'clio-kit mcp-server hdf5' 启动服务器。

claude_desktop_config.json
{
  "mcpServers": {
    "hdf5-mcp": {
      "command": "clio-kit",
      "args": ["mcp-server", "hdf5"]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同(如 VS Code 使用 servers 字段),可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "hdf5-mcp": {
      "command": "clio-kit",
      "args": [
        "mcp-server",
        "hdf5"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json(VS Code 使用 servers 字段)。

Terminal
claude mcp add hdf5-mcp -- clio-kit mcp-server hdf5

在终端运行;先把 <…> 占位符换成你自己的值。

验证是否装好

安装后运行 `clio-kit mcp-server hdf5`,在客户端中确认 hdf5-mcp 已连接且 open_file、list_keys 等工具出现在工具列表中,然后提问 "这个 HDF5 文件里有哪些数据集?" 验证可用。

常见排障

  1. 检查服务器命令是否正确,确保 HDF5 文件存在且可读,查看日志以排查 I/O 错误。

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 打开 climate_simulation.h5,分析文件结构并列出所有数据集。
  • 读取 temperature 数据集的前 100 个时间步。
  • 对 pressure 数据集并行计算统计信息,并检查是否存在 I/O 瓶颈。
  • 把当前数据集导出为 CSV 文件。

工具能力 27

open_file 只读
打开 HDF5 文件以进行操作。
close_file 只读
关闭当前 HDF5 文件。
get_filename 只读
获取当前文件的路径。
get_mode 只读
获取当前文件的访问模式。
get_by_path 只读
按路径获取数据集或组。
list_keys 只读
列出组中的所有键。
visit 只读
递归访问所有节点。
read_full_dataset 只读
读取整个数据集,支持大数据集的高效分块读取。
展开其余 19 个工具
read_partial_dataset 只读
使用切片读取数据集的一部分。
get_shape 只读
获取数据集的形状。
get_dtype 只读
获取数据集的数据类型。
get_size 只读
获取数据集的大小。
get_chunks 只读
获取数据集的块信息。
read_attribute 只读
从对象中读取属性。
list_attributes 只读
列出对象的所有属性。
hdf5_parallel_scan 只读
并行处理,快速扫描多个文件。
hdf5_batch_read 只读
并行读取多个数据集。
hdf5_stream_data 只读
高效流式传输大型数据集,并管理内存。
hdf5_aggregate_stats 只读
跨多个数据集并行计算统计信息。
analyze_dataset_structure 只读
分析并理解文件组织和数据模式,提供 AI 洞察。
find_similar_datasets 只读
使用 AI 分析查找与参考数据集相似的数据集。
suggest_next_exploration 只读
基于当前位置,使用 AI 推荐建议探索的有趣数据。
identify_io_bottlenecks 只读
使用 AI 推荐识别潜在的 I/O 瓶颈和性能问题。
optimize_access_pattern 只读
基于使用模式,为数据访问提供更好的方法建议。
refresh_hdf5_resources 只读
重新扫描客户端根目录,更新可用的 HDF5 资源。
list_available_hdf5_files 只读
列出所有已注册的 HDF5 文件及其资源 URI。
export_dataset 写入
以多种格式导出数据集,并可选择用户所选格式。

使用场景

AI 智能体分析 HDF5 文件中的科学数据,例如温度场。
自动化数据探索与结构分析。
并行读取多个 HDF5 数据集以加速工作流。
AI 辅助优化数据访问模式。

支持客户端

Claude Desktop

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

详细介绍

HDF5 MCP 服务器是 CLIO Kit 中用于科学数据访问的模型上下文协议服务器。它提供一组丰富的工具,使 AI 智能体能够打开、读取、查询和分析 HDF5 文件,并支持高效的分块读取、并行操作以及基于 AI 的数据结构分析和优化建议。

同类可选方案

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