CLIO Darshan

CLIO Kit

[License: BSD-3-Clause] [PyPI version] [Python] [FastMCP] [CI] [Coverage]

[MCP Servers] [Ruff] [Type Checked] [Package Manager] [Security Audit]

CLIO Kit - Part of the IoWarp platform's tooling layer for AI agents. A comprehensive collection of tools, skills, plugins, and extensions. It ships 22 Model Context Protocol (MCP) servers for scientific computing and enables AI agents to interact with HPC resources, scientific data formats, and research datasets.

Website | IOWarp

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

AI agents handle scientific computing tasks through natural language:

• ✅ "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
• ✅ "Find all documents where pressure exceeds 200 kPa" - Agentic Search retrieves

One unified interface. 22 MCP servers. Hybrid search engine. 150+ specialized tools. Built for research.

CLIO Kit is part of the IoWarp platform's comprehensive tooling ecosystem for AI agents. It brings AI assistance to your scientific computing workflow—whether you're analyzing terabytes of HDF5 data, managing Slurm jobs across clusters, or exploring research papers. Built by researchers, for researchers, at Illinois Institute of Technology with NSF support.

Part of IoWarp Platform: CLIO Kit is the tooling layer of the IoWarp platform, providing skills, plugins, and extensions for AI agents working in scientific computing environments.

One simple command. Production-ready, fully typed, BSD-3-Clause licensed, and live-tested in real HPC environments.

🚀 Quick Installation

One Command for Any Server

# Install the released CLI into its own persistent tool environmentuv tool install 'clio-kit==2.4.3'# If uv reports that its executable directory is not on PATH:uv tool update-shell
# List all 23 available MCP serversclio-kit mcp-servers
# Run any installed serverclio-kit mcp-server hdf5clio-kit mcp-server pandasclio-kit mcp-server slurm
# Agentic search — hybrid retrieval for scientific corporaclio-kit search serve               # Start search API serverclio-kit search query --namespace local_fs --q "pressure > 200 kPa"
# AI prompts also availableclio-kit prompts                    # List all promptsclio-kit prompt code-coverage-prompt # Use a prompt

uv tool install keeps CLIO Kit in a persistent, isolated tool environment. Use uvx --from 'clio-kit==2.4.3' clio-kit ... only for a temporary, one-shot invocation.

Released clio-kit wheels execute each embedded MCP server from that server's shipped uv.lock. The launcher uses a source-and-lock-addressed environment under the user cache, installs only production dependencies, and refuses to resolve an embedded server whose lock is missing. The --branch launcher option is an explicit development path and is not an immutable release-artifact path.

The root wheel also ships machine-readable user contracts for the locked JARVIS, SLURM, Spack, and Scientific Catalog servers. These artifacts are generated from real stdio tools/list exchanges and include canonical SHA-256 digests for downstream federation gates:

clio-kit mcp-contractsclio-kit mcp-contract clio-kit-jarvis-user-v3.5clio-kit mcp-contract clio-kit-slurm-user-v3clio-kit mcp-contract clio-kit-spack-user-v2.1clio-kit mcp-contract clio-kit-scientific-catalog-user-v1.1

{  "mcpServers": {    "hdf5-mcp": {      "command": "clio-kit",      "args": ["mcp-server", "hdf5"]    },    "pandas-mcp": {      "command": "clio-kit",      "args": ["mcp-server", "pandas"]    },    "slurm-mcp": {      "command": "clio-kit",      "args": ["mcp-server", "slurm"]    }  }}

# Add HDF5 MCPclaude mcp add hdf5-mcp -- clio-kit mcp-server hdf5
# Add Pandas MCPclaude mcp add pandas-mcp -- clio-kit mcp-server pandas
# Add Slurm MCPclaude mcp add slurm-mcp -- clio-kit mcp-server slurm

"mcp": {  "servers": {    "hdf5-mcp": {      "type": "stdio",      "command": "clio-kit",      "args": ["mcp-server", "hdf5"]    },    "pandas-mcp": {      "type": "stdio",      "command": "clio-kit",      "args": ["mcp-server", "pandas"]    }  }}

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

Available Packages

The version below is each MCP server's agent-facing contract version, not the containing clio-kit wheel version. JARVIS 3.4 and SLURM 3.0 have contracts redesigned for agent use. Spack is at 2.1, 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.

Agentic Search

Hybrid retrieval engine for scientific corpora — combines lexical (BM25), vector, graph, and scientific search (numeric range, unit matching, formula targeting) over namespaced document collections. DuckDB storage, FastAPI, async job queue, OpenTelemetry tracing, Prometheus metrics.

# Start the search API serverclio-kit search serve
# Index documents from a namespaceclio-kit search index --namespace local_fs
# Query with scientific operatorsclio-kit search query --namespace local_fs --q "pressure between 190 and 360 kPa"
# List indexed documentsclio-kit search list --namespace local_fs

API endpoints: /query, /jobs/index, /documents, /health, /metrics — full docs

📖 Usage Examples

HDF5: Scientific Data Analysis

"What datasets are in climate_simulation.h5? Show me the temperature field structure and read the first 100 timesteps."

Tools used: open_file, analyze_dataset_structure, read_partial_dataset, list_attributes

Slurm: HPC Job Management

"Submit simulation.py to Slurm with 32 cores, 64GB memory, 24-hour runtime. Monitor progress and retrieve output when complete."

Tools used: submit_slurm_job, check_job_status, get_job_output

ArXiv: Research Discovery

"Find the latest papers on diffusion models from ArXiv, get details on the top 3, and export citations to BibTeX."

Tools used: search_arxiv, get_paper_details, export_to_bibtex, download_paper_pdf

Pandas: Data Processing

"Load sales_data.csv, clean missing values, compute statistics by region, and save as Parquet with compression."

Tools used: load_data, handle_missing_data, groupby_operations, save_data

Plot: Data Visualization

"Create a line plot showing temperature trends over time from weather.csv with proper axis labels."

Tools used: line_plot, data_info

Agentic Search: Scientific Retrieval

"Find all chunks mentioning pressure above 200 kPa in the local_fs namespace."

CLI: clio-kit search query --namespace local_fs --q "pressure > 200 kPa"

🚨 Troubleshooting

# Verify server name is correctclio-kit mcp-servers
# Common names: hdf5, pandas, slurm, arxiv (not hdf5-mcp, pandas-mcp)

cd clio-kit-mcp-servers/hdf5uv sync --all-extras --devuv run hdf5-mcp

# Linux/macOScurl -LsSf https://astral.sh/uv/install.sh | sh
# Windowspowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Or via pippip install uv

uv tool install 'clio-kit==2.4.3'uv tool update-shell

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
• Develop New MCPs: Add servers for your research tools (CONTRIBUTING.md)
• 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
• Discussions: GitHub Discussions
• Website: https://docs.iowarp.ai/
• Project: IOWarp Project