
CLIO Parquet
io.github.iowarp由 GitHub 帳號 iowarp 發布v2.3.1更新於 Nov 14, 2026
Summarize Parquet files, preview columns, read row slices and aggregate values.
概覽
CLIO Kit 套件中的本機 MCP 伺服器,讓助理彙總 Parquet 檔案、預覽欄位、讀取資料列片段並計算彙總值。
- 可以做什麼
- 彙總 Parquet 檔案的內容
- 預覽檔案的欄位與結構
- 讀取指定的資料列片段
- 對資料計算彙總值
- 適用情境
- 當你處理欄式 Parquet 資料集,希望助理不必寫腳本就能檢視結構、抽樣資料列或快速計算彙總值時適用。它是 CLIO Kit 科學運算工具集合中的一個元件,適合已在使用該套件的研究與資料工程流程。
- 執行需求
- 以本機程序在使用者電腦上執行(僅限桌面端,無法在網頁執行),透過 CLIO Kit 啟動器從 clio-kit 的 PyPI 套件安裝。README 的安裝流程使用 uv 套件管理員並需要複製儲存庫;部分 CLIO Kit 伺服器還需額外系統軟體。未宣告驗證、環境變數或標頭。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 CLIO Parquet,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
CLIO Kit
[License: BSD-3-Clause] [PyPI version] [Python] [FastMCP] [CI] [Coverage]
[MCP Servers] [Ruff] [Type Checked] [Package Manager] [Security Audit]
CLIO Kit is the IoWarp meta-marketplace for scientific computing. It brings together MCP servers, workflow skills, plugins, agent definitions, and community contributions—including plugins from external marketplaces—and enables AI agents to interact with HPC resources, scientific data formats, and research datasets.
Choose individual MCPs, skills, agents and hooks—or a plugin that bundles what your workflow needs. A plugin can include any of these components; it does not need all four.
Documentation · For agents: read here.
Chat with us on Zulip or join us
Developed by [GRC Logo] Gnosis Research Center
❌ Without CLIO Kit
Working with scientific data and HPC resources requires manual scripting and tool-specific knowledge:
- ❌ Write custom scripts for every HDF5/Parquet file exploration
- ❌ Manually craft Slurm job submission scripts
- ❌ Switch between multiple tools for data analysis
- ❌ No AI assistance for scientific workflows
- ❌ Repetitive coding for common research tasks
✅ With CLIO Kit
Install workflow bundles, use skills to guide your agent, and discover community tools:
- ✅ "Analyze the temperature dataset in this HDF5 file" - HDF5 MCP does it
- ✅ "Submit this simulation to Slurm with 32 cores" - Slurm MCP handles it
- ✅ "Find papers on neural networks from ArXiv" - ArXiv MCP searches
- ✅ "Plot the results from this CSV file" - Plot MCP visualizes
- ✅ "Optimize memory usage for this pandas DataFrame" - Pandas MCP optimizes
- ✅ Workflow guidance - Skills explain tool sequences; optional agents help plan and review results
- ✅ Community contributions - Discover external plugins and marketplace collections
MCP servers · Skills · Plugins · Agents · Hooks · Community marketplaces
CLIO Kit is part of the IoWarp platform's tooling ecosystem for AI agents. Its meta-marketplace brings tools and reusable workflows together for scientific computing—from exploring HDF5 datasets and managing Slurm jobs to analyzing results and finding research papers. Built by researchers, for researchers, at Illinois Institute of Technology with NSF support.
Part of IoWarp Platform: CLIO Kit is the platform's meta-marketplace and tooling layer, bringing together MCP servers, skills, workflow plugins, agent definitions, and community marketplace collections.
One launcher for MCP servers. Individual components or workflow bundles. BSD-3-Clause licensed, with automated checks and real installation, MCP, and HPC workflow tests. See the validation guide for tested coverage and environment requirements.
🚀 Quick Installation
Recommended: Ask your agent:
Manual setup: Install this checkout's launcher, then choose an option below. For the no-clone release route (2.11.0 or newer), see selective installation.
Claude Code
Install a workflow plugin (bundle) with its MCP servers and skills:
Restart Claude Code after installation and confirm the servers connect. First launches download dependencies; see startup recovery if a server exceeds the client's connection timeout.
Or install an individual MCP or a skill collection:
Claude Code uses plugin install for component packages too. CLIO Kit lists
those separately from workflow plugins; see components and plugins.
Codex and Other Agents
Install a workflow's skills and MCP configuration together:
Also supports opencode, cursor, antigravity, vscode and claude-code.
This sets up project components; native agents and hooks need client-specific
adapters. See client installation and limits.
Install a bundle or one skill into your project:
Configure the required MCP servers using setup.md. Use your agent’s supported skill directory.
Install Skills with npm
Requires Node.js 22.20.0+. From your working project:
Replace codex with claude-code or antigravity. MCP servers require separate configuration.
Choose either the Python or npm installer for each skill. See the skills CLI guide for selecting skills, updates and removal.
One Command for Any Server
Once 2.11.0 is published, install it with uv tool install 'clio-kit>=2.11.0'
(2.11.0 or newer; earlier releases lack the skill, plugin and doctor commands).
uv tool install creates a persistent, isolated environment; use
uvx --from 'clio-kit>=2.11.0' clio-kit ... for a temporary, one-shot invocation.
The release separates the small launcher from component downloads: one MCP
fetches only that server, one skill fetches only its files, and a workflow selects
its components. Server dependencies stay isolated and locked. See
selective installation for release, checkout and native plugin routes.
The --branch option is for development, not an immutable release installation.
The wheel also includes machine-readable tool contracts for JARVIS, Slurm, Spack and Scientific Catalog, with SHA-256 digests for downstream verification:
Workflow Bundles
These are broad workflow plugins. Each combines its MCP servers and skills.
Some servers require additional system software. See setup and prerequisites. See plugin composition for primary bundles and task plugins that combine components across them.
For a complete dataset-report workflow—HDF5, Pandas, Plot, a skill, evidence review and a verification hook:
See dataset reports for inputs and verification limits.
Skills and Agents
Skills provide workflow instructions and guidance for interpreting results. Claude Code users can install skills or agent definitions separately:
The shared installer supports Codex, Claude Code, OpenCode, Cursor, Antigravity and VS Code. Codex, Claude Code and OpenCode also have adapters for the scientific agents and Dataset Report hooks. See client support.
Add the optional Clio Coder coding and research skills, including Materio procedures:
Individual skills also work: clio-kit skill install clio-kit-scientific-debugging --target .agents/skills.
Adapted Clio Coder skills use the clio-kit- prefix to distinguish them from upstream originals.
See Clio Coder integration for upstream packages and native plugin support.
Agentic Search
clio-agentic-search is a standalone hybrid
retrieval service in this repository, not an MCP server. It indexes documents and
serves lexical, vector, graph and metadata retrieval over a FastAPI API
(/query, /jobs/index, /documents, /health, /metrics). Run it from a
checkout with uv run clio serve inside clio-agentic-search/; the clio-kit
launcher does not ship it.
Contribute Servers, Skills or Plugins
Contribute a package folder under plugins/, skills/, agents/ or hooks/;
website builds and CI update the catalogues automatically. See the folder contribution guide.
Add skills here, or list a plugin maintained in your own repository:
submit generates a community entry for a pull request. External servers can use any language; servers hosted inside CLIO currently support Python, Node.js and Go.
Add an optional Claude Code hook with clio-kit plugin init my-plugin --hook. See the hook guide.
See the contribution guide and community guide for requirements and submission details.
Install in Cursor
Add to .cursor/mcp.json in your project, or ~/.cursor/mcp.json:
Install the workflow skills from your project:
See Cursor MCP docs and skills docs.
Install in Claude Code
From the CLIO Kit checkout, install the workflow plugin with its MCPs and skills:
Skills-only and agent plugins:
See setup.md for details.
Install in VS Code
Add to .vscode/mcp.json for GitHub Copilot:
Install the workflow skills from your project:
Start the servers with MCP: List Servers. The Codex extension uses the Codex configuration below. See VS Code MCP docs and skills docs.
Install in Claude Desktop
Edit claude_desktop_config.json through Settings → Developer → Edit Config:
Restart Claude Desktop. This config adds MCP servers only; CLIO's native skill and agent plugins target Claude Code. See Claude Desktop MCP docs.
Install in Codex
Add the MCP servers for Codex CLI or its IDE extension:
Install the workflow skills from your project:
Check /mcp and /skills in Codex. To install a complete supported workflow, use
clio-kit plugin install clio-dataset-report --client codex --project .; review
its hooks with /hooks before running it.
See Codex MCP docs and
skills docs.
Install in Antigravity
Open MCP Servers → Manage MCP Servers → View raw config and add:
Install the workflow skills from your project:
Reload the MCP configuration. For Antigravity CLI, start the first session from
this project with agy --new-project so its local skills and MCP configuration
are loaded. Reopen it with agy --project <project-name-or-id>.
Reuse .agents/skills if already installed for Codex.
CLIO does not yet ship a native Antigravity plugin.
See Antigravity MCP docs and
skills docs.
Available Packages
The version below identifies each MCP server's contract and runtime release,
independently of the containing clio-kit wheel version. JARVIS 3.7 and SLURM 3.0 have contracts
redesigned for agent use. Spack is at 2.3, while the other
contracts retain their existing 2.x identities until a focused upgrade.
The Spack install contract makes concretization explicit: reuse=true passes
spack install --reuse, while reuse=false passes spack install --fresh.
Agents should discover first, install only when needed, then pass the exact
spack_locate result to JARVIS for runtime loading. A find with no installed
match is normal typed data (count=0, packages=[]); locate reports the
distinct not_installed semantic, while real Spack failures remain errors.
📖 Usage Examples
HDF5: Scientific Data Analysis
Tools used: open_file, analyze_dataset_structure, read_partial_dataset, list_attributes
Slurm: HPC Job Management
Tools used: slurm_submit, slurm_list, slurm_describe
ArXiv: Research Discovery
Tools used: search_arxiv, get_paper_details, export_to_bibtex, download_paper_pdf
Pandas: Data Processing
Tools used: load_data, handle_missing_data, groupby_operations, save_data
Plot: Data Visualization
Tools used: line_plot, data_info
🚨 Troubleshooting
Server Not Found Error
If clio-kit mcp-server <server-name> fails:
Import Errors or Missing Dependencies
For development or local testing:
uv or clio-kit Command Not Found
Install uv package manager:
Then install CLIO Kit persistently and expose uv's tool directory:
Open a new shell after update-shell, then check it resolved:
Team
- Gnosis Research Center (GRC) - Illinois Institute of Technology | Lead
- HDF Group - Data format and library developers | Industry Partner
- University of Utah - Research collaboration | Domain Science Partner
Sponsored By
[NSF Logo] NSF (National Science Foundation) - Supporting scientific computing research and AI integration initiatives
we welcome more sponsorships. please contact the Principal Investigator
Ways to Contribute
- Submit Issues: Report bugs or request features via GitHub Issues
- Build MCP Servers: Contribute Python, Node.js or Go servers (guide)
- Write Skills: Share reusable scientific workflows (guide)
- Share Plugins or Marketplaces: List tools maintained in your own repository (guide)
- Improve Documentation: Help make guides clearer
- Share Use Cases: Tell us how you're using CLIO Kit in your research
Full Guide: CONTRIBUTING.md
Community & Support
- Chat: Zulip Community
- Join: Invitation Link
- Issues: GitHub Issues
- Website: https://toolkit.iowarp.ai/
- Project: IOWarp Project
來源:README.md,提交 52b66ad
工具
0版本歷史
5- v2.3.1最新Nov 14, 2026
- v2.3.0Nov 11, 2026
- v2.2.6Oct 29, 2026
- v2.2.5Oct 9, 2026
- v2.2.3Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分