Kaiord

Name: Kaiord
Author: pablo-albaladejo

von pablo-albaladejoVersion 10.5.0i★ –iComputer oder Cloud

Name in der Registryio.github.pablo-albaladejo/kaiord

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Convert, validate, and inspect workout files (FIT, TCX, ZWO, Garmin Connect) for AI agents.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi3 von 3 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Computer oder Cloud
Transport: stdio, Streamable HTTP
Kategorie: Praxen & Gesundheit

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 3 von 3 bestanden
Läuft auf dem Server des Entwicklers: Was du fragst, läuft über dessen Server.
Kann 8 Dinge (Tools) kaiord_get_format_spec, kaiord_list_formats, kaiord_convert, kaiord_validate …
Die Registry nennt keinen Schlüssel zum Eintragen.

Du brauchst

Läuft in der CloudNichts zu installieren; die Verbindung läuft übers Internet
npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Funktioniert in Claude im Web, auf dem Desktop und auf dem Handy:

Öffne Settings → Connectors
Tippe auf Add custom connector
Füge die Adresse unten ein und tippe auf Add
Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an

https://kaiord.com/mcp

Oder führ ihn auf deinem Computer aus

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "kaiord": {
      "command": "npx",
      "args": [
        "-y",
        "@kaiord/mcp"
      ]
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add --transport http kaiord https://kaiord.com/mcp

Oder führ ihn auf deinem Computer aus

claude mcp add kaiord -- npx -y @kaiord/mcp

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "kaiord": {
      "url": "https://kaiord.com/mcp"
    }
  }
}

Oder führ ihn auf deinem Computer aus

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "kaiord": {
      "command": "npx",
      "args": [
        "-y",
        "@kaiord/mcp"
      ]
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "kaiord": {
      "type": "http",
      "url": "https://kaiord.com/mcp"
    }
  }
}

Oder führ ihn auf deinem Computer aus

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "kaiord": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@kaiord/mcp"
      ]
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

ChatGPT verbindet sich nur mit Servern im Internet:

Öffne ChatGPT im Web → Settings → Connectors (Apps)
Tippe auf Create oder Add (bei manchen Tarifen musst du zuerst Developer mode unter Advanced einschalten)
Füge die Adresse unten ein, gib ihr einen Namen und speichere
Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an

https://kaiord.com/mcp

Menünamen können sich je nach Tarif und mit der Zeit leicht unterscheiden.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 7. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

kaiord_get_format_spec
Get the KRD format specification. Call this before creating or editing KRD documents.
kaiord_list_formats
List all supported fitness data formats with capabilities
kaiord_convert
Convert between fitness data formats (FIT, TCX, ZWO, GCN, KRD). FIT output is returned as base64 text unless output_file is given. On the remote endpoint, ZWO input is checked for well-formedness only, not against the XSD, and only structured workouts are accepted.
kaiord_validate
Validate a KRD JSON document against the schema On the remote endpoint, ZWO input is checked for well-formedness only, not against the XSD, and only structured workouts are accepted.
kaiord_round_trip_validate
Validate round-trip FIT conversion (FIT → KRD → FIT) and report tolerance violations
kaiord_inspect
Inspect a fitness file and return a human-readable summary
kaiord_extract_workout
Extract the structured workout from a fitness file as JSON
kaiord_diff
Compare two fitness files and show differences

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 8. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto pablo-albaladejo bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
✓ Bestanden
Endpunkt antwortet
Antwort in 358 ms (HTTP 200)
– Nicht zutreffend
Anmeldung mit OAuth
Keine Anmeldung nötig
✓ Bestanden
Keine versteckten Anweisungen in Tool-Beschreibungen
Wir haben 8 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Im Vergleich mit anderen in Praxen & Gesundheiti

Mehr Sterne als 0 % der anderen 1024 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 74 % der anderen 1024 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 1024 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Kaiord sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (10.5.0) kam vor 8 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL, also funktionieren auch Apps, die Remote-MCP-Server akzeptieren, zum Beispiel ChatGPT im Entwicklermodus.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Mirobody, FHIR MCP Server, Google Health MCP

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Mirobody

von thetahealth

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

Läuft auf deinem Computer★ 1.408Apache-2.0Aktualisiert heute

Installieren

FHIR MCP Server

von wso2

MCP server providing seamless access to FHIR APIs for AI tools and healthcare applications

Läuft auf deinem Computer★ 137Apache-2.0Aktualisiert vor 10 Tagen

Installieren

Google Health MCP

von davidmosiah

Privacy-first unofficial Google Health API v4 MCP server for health, sleep, activity, HR agents

Läuft auf deinem Computer★ 79MITAktualisiert vor 4 Monaten

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Kaiord — Open-Source Health & Fitness Data Framework

[kaiord.com](https://kaiord.com) | Editor | npm

Kaiord is an open-source framework for creating, converting, and managing health & fitness data.

It provides:

@kaiord/core: a TypeScript library with format adapters for .fit, .tcx, .zwo, and .krd (Kaiord) files, plus Garmin Connect API integration.
@kaiord/cli: a command-line tool to convert, validate, and compare files across formats.
@kaiord/mcp: an MCP server exposing Kaiord tools to AI agents (Claude Desktop, Claude Code, etc.). Published in the official MCP registry as io.github.pablo-albaladejo/kaiord.
[Workout Editor](https://kaiord.com/app/): a web application to create and edit workout files visually.

✨ Features

[Visual Workout Editor](https://kaiord.com/app/) - Create and edit workouts in your browser
Unified JSON-based format .krd (Kaiord Representation Definition)
Schema validation (Zod)
Round-trip safe conversions between FIT / TCX / ZWO / GCN / KRD
Hexagonal architecture & fully typed API

Supported FIT Fields

Workout Metadata

Sub-sport categorization: Detailed sport types (trail running, indoor cycling, lap swimming, etc.)
Pool dimensions: Pool length and unit for swimming workouts

Workout Steps

Coaching notes: Instructional text for each step (max 256 characters)
Swimming equipment: Fins, kickboard, paddles, pull buoy, snorkel

Duration Types

Time & distance: Standard interval durations
Calorie-based: Steps ending after burning specified calories
Power-based: Steps ending based on power thresholds (watts)
Heart rate conditionals: Steps ending based on HR thresholds (bpm)
Repeat conditionals: Repeat blocks until time/distance/calories/HR/power targets reached

Known Limitations

Training Stress Score (TSS): The training_peaks_tss duration type is not yet implemented in the FIT converter. This is a TrainingPeaks-specific metric that requires additional mapping logic. Contributions welcome!

🔒 Local-first architecture

Kaiord is local-first: your data lives on your device, because there is no Kaiord server to send it to. There are no accounts and no backend.

Storage is your browser's IndexedDB. The Workout Editor persists every workout, template, profile, and setting in a local Dexie.js / IndexedDB database (new KaiordDatabase() in dexie-database.ts), and the UI reads it reactively through useLiveQuery. Nothing is written to a remote database — see the "Persisted data → Dexie" rule in State Management.
Conversions run entirely on your machine. FIT / TCX / ZWO / GCN ↔ KRD conversion happens in-process — client-side in the editor (import-workout-formats.ts, export-workout-formats.ts) or locally in the @kaiord/cli. Files never leave your device to be converted.
Sync is opt-in and goes to _your_ cloud. Data leaves the device only if you connect Google Drive. The cloud-sync adapter uses the Google Identity Services drive.appdata scope, so synced data lands in your own Drive's app folder; the access token lives only in memory for the session and is never persisted by Kaiord.
Integrations use _your_ logged-in session — no credential proxy. Garmin, WHOOP, and Train2Go connect through browser-extension "bridges" (garmin-bridge, whoop-bridge, train2go-bridge) that piggyback on your existing browser session. Per openspec/specs/adapter-contracts/spec.md, a bridge "SHALL NOT store, transmit, or manage user credentials"; authentication is "delegated entirely to the browser's cookie jar." No third-party server proxies your credentials or your data.
Works offline. Because all logic and storage are client-side, the editor keeps working with no network connection once loaded.

📚 Documentation

Comprehensive documentation is available in the /docs directory:

[Getting Started](./docs/getting-started.md) - Installation, basic usage, and quick examples for both library and CLI
[Architecture](./docs/architecture.md) - Hexagonal architecture, ports & adapters pattern, and design principles
[Testing](./docs/testing.md) - Testing strategy, TDD workflow, and coverage requirements
[Deployment](./docs/deployment.md) - CI/CD pipeline, GitHub Pages deployment, and npm publishing
[Contributing](./CONTRIBUTING.md) - Contribution guidelines, development workflow, and code standards
[KRD Format](./docs/krd-format.md) - Complete specification of the Kaiord Representation Definition format
[AI Agents](./AGENTS.md) - Guidance for AI-assisted development

🧩 Tech Stack

Layer	Tooling
Core	TypeScript, tsdown, Zod
CLI	yargs
Web App	React, Zustand, Tailwind, Radix UI
Testing	Vitest, Playwright
Package manager	pnpm

🏗 Monorepo Layout

kaiord/

├─ packages/ │ ├─ core/ → domain types, schemas, ports & use cases │ ├─ fit/ → Garmin FIT format adapter │ ├─ tcx/ → Training Center XML adapter │ ├─ zwo/ → Zwift ZWO format adapter │ ├─ garmin/ → Garmin Connect API adapter │ ├─ cli/ → command-line interface │ ├─ mcp/ → MCP server for AI/LLM integration │ └─ workout-spa-editor/ → web application (https://kaiord.com/app/) ├─ docs/ → documentation ├─ LICENSE ├─ README.md └─ pnpm-workspace.yaml

🚀 Quick Start

Try the Web App

[Launch Workout Editor →](https://kaiord.com/app/)

Create and edit workouts visually in your browser. No installation required.

Use the Library

pnpm install

pnpm -r build pnpm -r test

Example usage

pnpm kaiord --help

For detailed installation instructions and usage examples, see the [Getting Started Guide](./docs/getting-started.md).

🚀 CI/CD Pipeline

Kaiord uses GitHub Actions for continuous integration and deployment:

Automated Testing: Multi-version testing on Node.js 22.x (Maintenance LTS) and 24.x (Active LTS)
Code Quality: ESLint, Prettier, and TypeScript strict mode validation
Release Automation: Changesets for version management and npm publishing
Security: Weekly dependency vulnerability audits, CodeQL static analysis, and automated dependency updates

For complete CI/CD documentation, deployment guides, and npm publishing instructions, see [Deployment](./docs/deployment.md).

Mechanical invariant guards

Beyond linting, the repo enforces its architecture and conventions with 60+ purpose-built guard scripts under scripts/, each with its own co-located test suite. They run on every commit (husky pre-commit) and in CI (pnpm test:scripts), and cover, among others:

Hexagonal architecture — layer purity, adapter isolation, and the packages/core/src/ directory allowlist (check-architecture.mjs)
Package dependency graph — every @kaiord/* dependency must match the spec table (check-package-deps.mjs)
Test conventions — should -prefixed titles and Arrange/Act/Assert structure on every test (check-test-title-should.mjs, check-test-aaa.mjs)
Privacy — no runtime values interpolated into toasts or console logs (check-no-pii-leakage.mjs)
State discipline — no Zustand store writes persistence directly (check-no-zustand-writethrough.mjs)
Spec hygiene — OpenSpec format, archive dates, and auto-generated indexes stay in sync (check-spec-format.mjs, check-archive-*.mjs)

If a rule matters here, a script enforces it — documentation describes the rules, but the guards are what make them true.

Contributing

To contribute to Kaiord:

Fork and clone the repository
Create a feature branch: git checkout -b feature/my-feature
Make your changes following the code style guidelines
Add a changeset: pnpm exec changeset (for version-worthy changes)
Test locally: pnpm -r test and pnpm -r build
Submit a PR: All checks must pass before merging

For detailed contribution guidelines, development workflow, and code standards, see [Contributing](./CONTRIBUTING.md).

📚 References & Resources

Format Specifications

Garmin FIT SDK (JavaScript) - Official FIT protocol implementation
FIT Workout Files Cookbook - Guide to encoding workout files
FIT File Types: Workout - Workout file type specification
Training Center XML (TCX) - Garmin's XML-based format
TCX Schema (XSD) - Official Garmin TCX schema definition
Zwift Workout Format (ZWO) - Zwift's XML-based workout format

❤️ Support

If you find Kaiord useful, consider supporting its development:

⭐ Star this repo to help others discover it
💖 [Sponsor on GitHub](https://github.com/sponsors/pablo-albaladejo)
☕ [Buy me a coffee](https://buymeacoffee.com/pabloalbaladejo)

Your support helps maintain and improve Kaiord for the fitness community!

Built by [Pablo Albaladejo](https://pabloalbaladejo.com)

Kaiord

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Oder führ ihn auf deinem Computer aus

Oder führ ihn auf deinem Computer aus

Oder führ ihn auf deinem Computer aus

Oder führ ihn auf deinem Computer aus

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Praxen & Gesundheiti

Häufige Fragen

Alternativen

Mirobody

FHIR MCP Server

Google Health MCP

README vom Entwickler

Kaiord — Open-Source Health & Fitness Data Framework

✨ Features

Supported FIT Fields

Workout Metadata

Workout Steps

Duration Types

Known Limitations

🔒 Local-first architecture

📚 Documentation

🧩 Tech Stack

🏗 Monorepo Layout

🚀 Quick Start

Try the Web App

Use the Library

Example usage

🚀 CI/CD Pipeline

Mechanical invariant guards

Contributing

📚 References & Resources

Format Specifications

❤️ Support

📜 License