@kaiord/mcp 4.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +77 -0
- package/dist/bin/kaiord-mcp.js +733 -0
- package/dist/index.d.ts +41 -0
- package/dist/index.js +724 -0
- package/dist/package.json +3 -0
- package/package.json +78 -0
package/README.md
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# @kaiord/mcp
|
|
2
|
+
|
|
3
|
+
Model Context Protocol (MCP) server for Kaiord. Exposes fitness file conversion, validation, and inspection tools to AI agents (Claude Desktop, Claude Code, etc.).
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g @kaiord/mcp
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Configuration
|
|
12
|
+
|
|
13
|
+
### Claude Desktop / Claude Code
|
|
14
|
+
|
|
15
|
+
Add to your MCP configuration:
|
|
16
|
+
|
|
17
|
+
```json
|
|
18
|
+
{
|
|
19
|
+
"kaiord": {
|
|
20
|
+
"type": "stdio",
|
|
21
|
+
"command": "npx",
|
|
22
|
+
"args": ["-y", "@kaiord/mcp"]
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
### Local development (monorepo)
|
|
28
|
+
|
|
29
|
+
```json
|
|
30
|
+
{
|
|
31
|
+
"kaiord": {
|
|
32
|
+
"type": "stdio",
|
|
33
|
+
"command": "node",
|
|
34
|
+
"args": ["./packages/mcp/dist/bin/kaiord-mcp.js"]
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Tools
|
|
40
|
+
|
|
41
|
+
| Tool | Description |
|
|
42
|
+
| ------------------------ | --------------------------------------------------- |
|
|
43
|
+
| `kaiord_convert` | Convert between FIT, TCX, ZWO, GCN, and KRD formats |
|
|
44
|
+
| `kaiord_validate` | Validate KRD JSON against the schema |
|
|
45
|
+
| `kaiord_inspect` | Parse and summarize any fitness file |
|
|
46
|
+
| `kaiord_diff` | Compare two fitness files |
|
|
47
|
+
| `kaiord_extract_workout` | Extract structured workout definition |
|
|
48
|
+
| `kaiord_list_formats` | List supported formats and capabilities |
|
|
49
|
+
|
|
50
|
+
## Resources
|
|
51
|
+
|
|
52
|
+
| URI | Description |
|
|
53
|
+
| -------------------------- | ----------------------------------- |
|
|
54
|
+
| `kaiord://schema/krd` | KRD JSON Schema |
|
|
55
|
+
| `kaiord://formats` | Supported formats with capabilities |
|
|
56
|
+
| `kaiord://docs/krd-format` | KRD format specification |
|
|
57
|
+
|
|
58
|
+
## Prompts
|
|
59
|
+
|
|
60
|
+
| Name | Description |
|
|
61
|
+
| ----------------- | --------------------------------------- |
|
|
62
|
+
| `convert_file` | Guided file conversion workflow |
|
|
63
|
+
| `analyze_workout` | Inspect + extract + summarize a workout |
|
|
64
|
+
|
|
65
|
+
## Supported Formats
|
|
66
|
+
|
|
67
|
+
| Format | Extension | Type | Description |
|
|
68
|
+
| ------ | --------- | ------ | ---------------------------- |
|
|
69
|
+
| FIT | `.fit` | Binary | Garmin FIT protocol |
|
|
70
|
+
| TCX | `.tcx` | Text | Training Center XML |
|
|
71
|
+
| ZWO | `.zwo` | Text | Zwift workout XML |
|
|
72
|
+
| GCN | `.gcn` | Text | Garmin Connect workout JSON |
|
|
73
|
+
| KRD | `.krd` | Text | Kaiord canonical JSON format |
|
|
74
|
+
|
|
75
|
+
## License
|
|
76
|
+
|
|
77
|
+
MIT
|