MCP server and Python library for working with IMAS Standard Names — a controlled vocabulary for fusion data variables.
Configure your AI assistant to use the standard names tools:
# Install the MCP server uv tool install imas-standard-names # Or with pip pip install imas-standard-namesAdd to your MCP configuration (e.g., Claude Desktop, VS Code):
{ "mcpServers": { "imas-standard-names": { "command": "standard-names-mcp" } } }from imas_standard_names import StandardNameCatalog catalog = StandardNameCatalog() entry = catalog.get("electron_temperature") print(f"{entry.name}: {entry.unit} — {entry.description}")The tools and catalog are distributed separately:
| Package | Purpose |
|---|---|
imas-standard-names | MCP server, grammar, validation tools |
imas-standard-names-catalog | Standard names catalog (YAML + SQLite) |
# Tools + catalog (recommended) pip install imas-standard-names[catalog] # Tools only pip install imas-standard-namesThe catalog can be accessed in several ways:
# Option 1: Install catalog package (recommended) pip install imas-standard-names-catalog # Option 2: Download pre-built database wget https://github.com/iterorganization/imas-standard-names-catalog/releases/latest/download/catalog.db export STANDARD_NAMES_CATALOG_DB=./catalog.db # Option 3: Clone catalog repository (for editing) git clone https://github.com/iterorganization/imas-standard-names-catalog.git export STANDARD_NAMES_CATALOG_ROOT=./imas-standard-names-catalog/standard_namesgit clone https://github.com/iterorganization/imas-standard-names.git cd imas-standard-names uv syncThis project uses a two-repository architecture:
- imas-standard-names (this repo): MCP server, grammar, validation, Python API
- imas-standard-names-catalog: YAML source files and pre-built SQLite database
This separation allows independent versioning — catalog content evolves separately from tooling.
Full documentation: iterorganization.github.io/IMAS-Standard-Names
- Grammar Reference — naming rules and vocabulary
- Guidelines — patterns and conventions
- Quick Start — creating new standard names
The MCP server provides tools for AI assistants to work with standard names:
| Tool | Purpose |
|---|---|
search_standard_names | Find names by concept using semantic search |
list_standard_names | List all names with filtering by status, tags, kind |
fetch_standard_names | Get complete metadata for specific names |
check_standard_names | Fast batch validation of name existence |
| Tool | Purpose |
|---|---|
get_grammar | Grammar rules, patterns, and composition guidance |
get_schema | Entry schema for creating standard names |
get_vocabulary | Controlled vocabulary tokens by segment |
| Tool | Purpose |
|---|---|
compose_standard_name | Build valid names from structured parts |
parse_standard_name | Parse names into grammatical components |
| Tool | Purpose |
|---|---|
create_standard_names | Create new catalog entries (in-memory) |
edit_standard_names | Modify, rename, or delete entries (in-memory) |
write_standard_names | Persist pending changes to disk |
| Tool | Purpose |
|---|---|
validate_catalog | Check catalog integrity and grammar |
manage_vocabulary | Vocabulary gap detection and management |
get_tokamak_parameters | Reference tokamak machine parameters |
MIT
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}