Metaseed

Schema-driven metadata management from YAML specifications.

Documentation | Introduction Slides

What is Metaseed?

A schema-driven metadata management system that:

• Defines entity schemas in human-readable YAML
• Generates Pydantic models dynamically at runtime
• Validates with composable rules
• Supports multiple metadata standards (MIAPPE, ISA, Darwin Core, ...)
• Exports a dataset as a DCAT catalog card (JSON-LD / Turtle) for data portals and FAIR assessment

YAML specs → Pydantic models → Validation → Serialization

Installation

Requires Python 3.11+

# Install from GitHub
uv tool install git+https://github.com/sorenwacker/metaseed.git

# Or for development
git clone https://github.com/sorenwacker/metaseed.git
cd metaseed
uv sync --extra dev

Supported Profiles

Counts are for the latest version of each profile.

User-defined profiles supported in ~/.local/share/metaseed/specs/

Integrations

Adapters connect a dataset to an external service or format. They are separate from profiles: a profile is a metadata standard, an adapter is a route in or out.

Modi Operandi

Metaseed operates in four modes:

CLI Mode

# List entities in a profile
metaseed entities miappe 1.2

# Generate entity template
metaseed template miappe 1.2 Investigation

# Validate a dataset
metaseed validate dataset.yaml --profile miappe --version 1.2

# Start web UI
metaseed ui

# Start MCP server (for Claude Desktop)
metaseed mcp --transport stdio

Python API

from metaseed import MetaseedClient

client = MetaseedClient("miappe", "1.2")

# Create root entity
inv = client.create_entity("Investigation", {
    "unique_id": "INV001",
    "title": "Drought Tolerance Study",
    "description": "Multi-year field trial..."
})

# Create child with parent linkage
study = client.create_entity("Study", {
    "unique_id": "STU001",
    "title": "Field Trial 2024",
    "start_date": "2024-03-01"
}, parent_id=inv.id)

# Validate entire dataset
result = client.validate()
print(f"Valid: {result.is_valid}, Errors: {len(result.errors)}")

Architecture

graph LR
    subgraph interfaces["Interfaces"]
        direction RL
        CLI["CLI"]
        UI["Web UI"]
        API["REST API"]
        MCP["MCP Server"]
    end

    subgraph core["Core"]
        Client["MetaseedClient"]
        Facade["ProfileFacade"]
        Factory["Model Factory"]
        Validators["Validation Engine"]
    end

    subgraph data["Data Layer"]
        Specs["YAML Specs"]
        Repo["Entity Storage"]
        Storage["JSON/YAML Files"]
    end

    interfaces --> Client
    Client --> Facade
    Facade --> Factory
    Facade --> Validators
    Factory --> Specs
    Validators --> Repo
    Repo --> Storage

Validation

Composable validation rules defined in YAML:

• Required field checking
• Pattern matching (regex)
• Range validation (min/max)
• Date range validation
• Coordinate pair validation
• Uniqueness constraints (within parent or global)
• Referential integrity (foreign keys)
• Conditional rules

validation:
  - type: uniqueness
    entity: Study
    field: unique_id
    scope: parent

  - type: referential_integrity
    entity: ObservationUnit
    field: study_id
    references:
      entity: Study
      field: unique_id

MCP Integration

Model Context Protocol enables AI-assisted metadata extraction with Claude.

Tool categories:

• Profile Discovery — list_profiles, get_profile_schema
• File Extraction — parse_source_file, extract_entities
• Entity CRUD — create_entity, update_entity, delete_entity
• Validation — validate_entity, validate_dataset
• Ontology — search_ontology, suggest_ontology_term

Technology Stack

Development

make setup    # Install dependencies + pre-commit hooks
make dev      # Start development server
make test     # Run tests
make lint     # Run linter
make docs     # Serve documentation locally

Data sources and attribution

Ontology term lookup and validation use the EMBL-EBI Ontology Lookup Service (OLS4). Term data is retrieved from the public OLS4 API and remains the property of the respective source ontologies. Use of OLS is subject to the EMBL-EBI Terms of Use.

Metaseed is a considerate API client: it caches results, rate-limits requests, and identifies itself with a descriptive User-Agent. For bulk or high-volume term resolution, prefer downloading the source ontologies or running a local OLS instance rather than the public API.

License

MIT