Kaiord

Name: Kaiord
Author: pablo-albaladejo

de pablo-albaladejoversión 10.5.0i★ –iComputadora o nube

Nombre en el registroio.github.pablo-albaladejo/kaiord

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi3 de 3 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo↓ 159/sem · ★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Computadora o nube
Transporte: stdio, Streamable HTTP
Categoría: Clínicas y salud

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 3 de 3 superadas
Se ejecuta en el servidor del creador: lo que le pidas pasa por su servidor.
Puede hacer 8 cosas (herramientas) kaiord_get_format_spec, kaiord_list_formats, kaiord_convert, kaiord_validate …
El registro no indica ninguna clave que completar.

Necesitas

Se ejecuta en la nubeNo hay nada que instalar; se conecta por internet
npmNode.js instalado (para el comando npx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Funciona en Claude para web, escritorio y móvil:

Abre Settings → Connectors
Presiona Add custom connector
Pega la dirección de abajo y presiona Add
Si te pide iniciar sesión, inicia sesión en el servicio del creador

https://kaiord.com/mcp

O ejecútalo en tu computadora

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

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

Ejecuta esto en tu terminal

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

O ejecútalo en tu computadora

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

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

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

O ejecútalo en tu computadora

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

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

O ejecútalo en tu computadora

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

ChatGPT solo se conecta a servidores en internet:

Abre ChatGPT en la web → Settings → Connectors (Apps)
Presiona Create o Add (en algunos planes primero hay que activar Developer mode en Advanced)
Pega la dirección de abajo, ponle un nombre y guarda
Si te pide iniciar sesión, inicia sesión en el servicio del creador

https://kaiord.com/mcp

Los nombres de los menús pueden variar un poco según el plan y con el tiempo.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 7 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

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

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 8 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub pablo-albaladejo, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
✓ Superada
El endpoint responde
Respondió en 358 ms (HTTP 200)
– No aplica
Inicio de sesión con OAuth
No hace falta iniciar sesión
✓ Superada
Sin instrucciones ocultas en las descripciones de herramientas
Leímos 8 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Comparado con otros en Clínicas y saludi

Más estrellas que el 0% de los otros 1027 servidores de esta categoría
Publicado en el registro más recientemente que el 74% de los otros 1027 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 1027 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Kaiord?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (10.5.0) llegó al registro hace 9 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también funcionan las apps que aceptan servidores MCP remotos, como ChatGPT en modo desarrollador.

¿Qué puedo usar en su lugar?

En la misma categoría: Mirobody, FHIR MCP Server, Google Health MCP

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Mirobody

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

de thetahealthEn crecimiento↓ 290/sem★ 1,4 milActualizado ayer

Se ejecuta en tu computadora✓ thetahealth.ai

Instalar

FHIR MCP Server

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

de wso2En crecimiento↓ 823/sem★ 137Actualizado hace 10 días

Se ejecuta en tu computadora

Instalar

Google Health MCP

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

de davidmosiahEn crecimiento↓ 1 mil/sem★ 79Actualizado hace 4 meses

Se ejecuta en tu computadora

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

O ejecútalo en tu computadora

O ejecútalo en tu computadora

O ejecútalo en tu computadora

O ejecútalo en tu computadora

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Clínicas y saludi

Preguntas frecuentes

Alternativas

Mirobody

FHIR MCP Server

Google Health MCP

README del creador

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