MESA¶

MESA wires the CyVerse data-management MCP servers into your AI coding agent — Claude Code, Codex CLI, Antigravity, or OpenCode — with a single command. One installer clones, builds, and registers everything you need to browse and curate the CyVerse Data Store (iRODS), apply ontology-backed metadata, and launch Discovery Environment apps — all from natural language.

Install¶

curl -fsSL https://raw.githubusercontent.com/idss-mesa/docs/main/install.sh | bash

Runs on Linux, macOS, and Windows Subsystem for Linux (WSL). By default it uses anonymous public CyVerse access — no credentials required to get started.

Get started Install reference

What gets installed¶

Server	Language	What it does
mesa-mcp	Python	iRODS Data Store (`ds_`) + OBO/OLS ontology AVUs (`mesa_ols_`, `mesa_avu_*`) + DataCite + DuckLake metadata history
mesa-ducklake	Python	AVU metadata-history library that backs mesa-mcp (installed alongside it — not a standalone server)
irods-mcp-server	Go	Reference iRODS Data Store MCP server
formation-mcp	Go	CyVerse Discovery Environment — launch apps, manage analyses

After install, the three servers (mesa-mcp, irods, formation) are registered with every client the installer detected. Open your agent and ask it to "ping the CyVerse Data Store" to confirm the link — see the Quickstart for per-client verification.

How it fits together¶

graph LR
  subgraph clients [Agent clients]
    CC[Claude Code]
    CX[Codex CLI]
    AG[Antigravity]
    OC[OpenCode]
  end
  clients -->|stdio| M[mesa-mcp]
  clients -->|stdio| I[irods-mcp-server]
  clients -->|stdio| F[formation-mcp]
  M -->|imports| D[mesa-ducklake]
  M --> IR[(CyVerse iRODS<br/>data.cyverse.org)]
  I --> IR
  F --> DE[(Discovery Environment<br/>Formation API)]
  D --> PQ[(DuckLake catalog<br/>+ Parquet)]

Source repositories live in the idss-mesa GitHub organization.