Garmin文档MCP服务器
MCP（模型上下文协议）服务器，提供 全面离线访问 对于像Claude这样的人工智能助手，Garmin Connect IQ SDK 8.2.3文档生态系统是完整的。
特性
🚀 完全离线：使用本地文档-无需互联网！\ 📚 完整的文件：访问API文档、编程指南、设备参考、常见问题解答和可视化资源（1407多个文件）\ 🔍 增强型搜索：具有模糊匹配和交叉引用支持的深度语义搜索\ ⚡ 快速：即时响应的本地解析和索引\ 🎯 准确的版本控制：正确的API级别到SDK版本映射（修复常见混淆）\ 📱 设备特定信息：硬件功能、内存限制、圆形设备支持\ 📖 编程指南：入门教程、调试、测试和最佳实践\ ❓ 常见问题解答和故障排除：字体、内存、图形等常见问题
v1.0.1新功能
✨ 修复API级别混淆：现在正确显示 API Level 4.2.0 (≈ SDK 6.x+) 而不是误导性的版本信息\ ✨ 固定模块功能：关键错误修复-现在可以正确找到所有模块级函数（Math.stdev、Cryptography.createPublicKey等）\ ✨ 3新工具：设备参考搜索、编程指南和常见问题搜索\ ✨ 增强覆盖范围：现在索引编程指南、设备文档、常见问题解答资源和个性库\ ✨ 更好的搜索结果：在主搜索中包含指南内容，并提供全面的交叉引用
服务器提供以下工具：
核心API工具
- search_garmin.docs：增强了对模块、类、方法、属性、常量和指南的搜索
- get_module_tails：完整的模块信息，带有正确的版本映射
- get_class_details：具有适当SDK版本上下文的详细类信息
- list_modules：包含统计信息的所有SDK 8.2.3模块的综合列表
- get_api_示例：使用SDK版本特定语法的代码示例
新文档工具
- search_device_reference：搜索设备特定的功能、内存限制和硬件功能
- 获取编程指南：访问入门指南、教程和开发最佳实践
- search_faq：查找常见问题（字体、内存、图形等）的故障排除信息
安装
- 克隆或下载此存储库
- 将Garmin Connect IQ SDK 8.2.3文档复制到
docs/项目根目录中的文件夹 - 安装依赖项：
npm install- 构建项目：
npm run build备注：首次运行时，服务器将自动解析并索引所有文档文件。最初可能需要几秒钟，但后续运行将是即时的。
用法
运行服务器
发展：
npm run dev生产：
npm start克劳德代码配置（推荐）
使用Claude Code CLI添加MCP服务器：
# Add the server (run from any directory)
claude mcp add garmin-documentation /path/to/garmin-documentation-mcp-server/dist/index.js
# Or add at project scope for team collaboration
claude mcp add --scope project garmin-documentation /path/to/garmin-documentation-mcp-server/dist/index.js验证安装:
claude mcp listClaude桌面配置
将此服务器添加到您的Claude Desktop配置文件中：
在macOS上: ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上: %APPDATA%\\Claude\\claude_desktop_config.json
{
"mcpServers": {
"garmin-documentation": {
"command": "node",
"args": ["/path/to/garmin-documentation-mcp-server/dist/index.js"]
}
}
}替换 /path/to/garmin-documentation-mcp-server 安装的实际路径。
可用工具
核心API工具
search_garmin.docs
在整个Garmin Connect IQ文档生态系统中增强搜索。
参数：
query（必填）：搜索词category（可选）：按类型筛选（“模块”、“类”、“函数”或“全部”）
v1.0.1中的新功能：现在在搜索结果中包含编程指南、设备文档和常见问题解答，并具有正确的API级别到SDK版本映射。
get_module_tails
使用更正的版本信息获取特定模块的详细信息。
参数：
module_name（必填）：模块名称（例如，“系统”、“活动”、“WatchUi”）
改进：显示 API Level 4.2.0 (≈ SDK 6.x+) 而不是混淆原始API级别。
get_class_details
使用适当的SDK版本上下文获取特定类的详细信息。
参数：
class_name（必填）：班级名称module_name（可选）：包含类的模块
list_modules
列出所有可用的Garmin Connect IQ模块，并附上说明和统计数据。
get_api_示例
获取具有SDK版本特定语法的特定功能的代码示例。
参数：
topic（必填）：示例主题（例如，“活动监测”、“蓝牙”、“观察空间”）
新文档工具（v1.0.1）
search_device_reference
搜索设备特定的参考文档和硬件功能。
参数：
query（必填）：设备功能、内存限制或硬件功能的搜索词device_type（可选）：设备类型过滤器（例如，“手表”、“自行车”、“高尔夫”）
用例：查找内存限制、圆形设备支持、硬件特定功能。
获取编程指南
访问Connect IQ开发的编程指南和教程。
参数：
topic（必填）：编程主题（例如，“入门”、“应用类型”、“调试”、“测试”）
覆盖：入门指南、应用程序开发教程、编译器文档、调试技巧。
search_faq
搜索常见问题和故障排除信息。
参数：
query（必填）：常见问题或故障排除主题的搜索词
主题包括：字体渲染、内存管理、图形优化、音乐控制、地图集成等。
Claude使用示例
配置后，您可以向Claude提出以下问题：
API核心问题
- “在Garmin Connect IQ中搜索蓝牙功能”
- “显示系统模块的详细信息”
- “获取创建表盘的示例”
- “活动模块中有哪些课程？”
- “列出所有可用模块”
- “查找与心率监测相关的方法”
新的v1.0.1功能
- “SDK 7中有复杂功能吗？”✅ *现在通过正确的版本映射正确回答*
- “如何使用stdev功能？”✅ *现在找到Math.stdev及其完整示例*
- “显示createPublicKey的用法”✅ *现在通过示例找到Cryptography.createPublicKey*
- “我如何开始Connect IQ开发？”
- “不同Garmin设备的内存限制是什么？”
- “我如何在应用程序中支持圆形设备？”
- “API级别和SDK版本有什么区别？”
- “如何解决字体呈现问题？”
- “查找手表内存功能的设备参考”
管理命令（克劳德代码）
# List all configured MCP servers
claude mcp list
# Get details about the server
claude mcp get garmin-documentation
# Remove the server
claude mcp remove garmin-documentation文件覆盖范围
API模块（33个模块、282个类、27+个模块函数）
该服务器提供对所有主要Garmin Connect IQ模块的访问，包括：
- 活动：活动记录和监测
- 活动监视器：每日活动指标
- 蚂蚁：ANT无线通信
- 应用：应用程序框架和生命周期
- 蓝牙低能量：BLE通信
- 并发症：观察面部并发症(✅ 在SDK 6.x+中可用，而不是之前令人困惑的4.2+）
- 密码学：加密、密钥生成、createPublicKey（）、randomBytes（）
- 图形：绘图和渲染，createBuffered位图（），createColor（）
- 数学：统计函数，如stdev（）、mean（）、variance（）以及三角函数
- 位置：全球定位系统和定位服务
- 传感器：设备传感器访问
- 系统：核心系统功能（包括圆形设备检测）
- WatchUi：用户界面组件
- 还有20多个模块。..
其他资源（共1407+个文件）
- 编程指南：入门教程、应用程序类型、调试、编译器文档
- 设备参考：硬件规格、内存限制、所有支持设备的功能
- FAQ资源：字体、图形、内存、音乐、地图和常见问题的故障排除指南
- 个性库：UI模式、图像、颜色、一致应用程序设计的确认
- 用户体验指南：用户体验最佳实践和设计模式
版本准确性
✅ 已修复重大问题：API级别混淆已解决\ ✅ 正确映射：API 4.2.0级正确映射到≈SDK 6.x+\ ✅ SDK 7支持已确认：并发症、活动信息、圆形设备均得到适当支持
许可证
麻省理工学院