Skip to content

miguel-escribano/openair-client

v0.1.0MIT

openair MCP client — ingest, prepare-plot, and workflow skills. Pairs with openair-3-mcp-server-oss.

Changelog

All notable changes to this project are documented here. Format follows Keep a Changelog; versioning follows SemVer.

This repo is versioned together with openair-3-mcp-server-oss — pair matching releases.

[Unreleased]

Added

  • CITATION.cff — machine-readable citation metadata (GitHub "Cite this repository").
  • CONTRIBUTING.md — dev setup, skill-adding guide, testing gate, PR process.
  • reproductions/ — runnable, no-chat-model reproduction of the openair book's Marylebone Road NOx polar plot example (live AURN NOx + Open-Meteo ERA5 wind, since site MY1 reports no wind of its own). Verified live against the deployed server; reference output committed.

[0.1.0] - 2026-06-30

Initial public release of the client plugin.

Added

  • openair-agent persona and guardrails O1–O6 (agents/openair-agent.md) — analyst contract, routing rules, no client-side date parsing or array building.
  • Router skill (skills/openair/) — auto-routes by data modality to specialist skills.
  • Manual skills — ingest-local, ingest-local-export, ingest-network, prepare-plot, multi-mcp.
  • Workflow recipes (skills/workflows/) — regional Excel, public-network plot, remote upload.
  • Acceptance test harness — tests/run_series_exercises.py (12 checks) + tests/run_wind_exercises.py (4 checks) against a deployed MCP server.
  • Felisa WindSeriesV1 golden fixture (tests/fixtures/felisa_munarriz.json) — real Open-Meteo ERA5 wind data, Pamplona station.
  • .mcp.json.example (Claude/Cursor/Codex) and .vscode/mcp.json example (VS Code) — local stdio, local HTTP, and remote HTTP + token setups.
  • Example walkthroughs — AURN time plot, CSV calendar plot, regional Excel (Spain), VS Code remote-MCP smoke test, plot catalog.
  • Multi-IDE plugin manifests — .claude-plugin/, .codex-plugin/, .cursor-plugin/, .github/copilot-instructions.md.