关于 Connect IQ MCP
Connect IQ MCP 面向 Garmin Connect IQ 开发者,让 Agent 查询商店数据、构建 SDK 项目并操作模拟器。默认只读,发布或修改商店内容前会请求确认。
主要功能
- 01查询应用版本、评价和安装量
- 02构建 SDK 项目
- 03运行模拟器并获取截图
- 04默认隐藏写入工具
- 05公开操作前显示预览并确认
适用场景
- 01查看应用下载量和评分
- 02构建并模拟测试手表应用
- 03发布版本前核对商店信息
MCP 相关
作为 MCP 服务向 Agent 暴露商店、SDK 构建和模拟器工具集;Garmin Connect 数据需单独启用。商店写入工具默认不提供,公开操作需要确认。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍

Connect IQ MCP
面向 Garmin Connect IQ 开发者的 MCP 服务。你的 Agent 可以获取应用商店信息(版本、应用列表、评论、安装量)、SDK 构建、模拟器,以及可选的 Garmin Connect 数据。默认只读,任何公开操作前都会征求你的同意。二进制文件名为 connect-iq-mcp。
安装
将以下内容粘贴给此刻正在为你编写表盘的 AI:
Set up the connect-iq-mcp server for me: https://github.com/idoo/connect-iq-mcp/blob/main/docs/INSTALL.md
或者手动分三步完成:
curl -fsSL https://github.com/idoo/connect-iq-mcp/releases/latest/download/install.sh | sh # or: brew install idoo/tap/connect-iq-mcp
connect-iq-mcp auth login # opens Garmin's sign-in page, tick Remember me
connect-iq-mcp config install claude-code # or claude-desktop, codex, cursor, vscode, windsurf
构建和模拟器还需要 Garmin 的 SDK Manager 和 Java 17+。详细说明以及 Windows 和 Linux 指南见:docs/INSTALL.md。登录、签名密钥、CI、升级和修复见:docs/FAQ.md。
为什么你可以信任它
你要把 Garmin 开发者账户交给它,因此,与其听我说,不如亲自检查以下内容:
- 所有代码都在这里。 MIT 许可,没有封闭部分。你可以用
go install github.com/idoo/connect-iq-mcp/cmd/connect-iq-mcp@latest自行构建。 - 它只与 Garmin 通信。 开发者门户
apps.garmin.com、登录浏览器中的 Garmin SSO,以及启用后使用的 Garmin Connect。没有遥测数据。SECURITY.md - 没有任何工具能看到你的密码或 Cookie。 你在独立的浏览器配置文件中登录 Garmin 官方页面。会话 Cookie 会存入操作系统密钥链,任何工具都不会获取或返回它。SECURITY.md
- 除非你另行允许,否则始终只读。 启用写入功能前,不会列出商店写入工具;任何公开操作都会先显示预览,并等待你确认。docs/SAFETY.md
- 发布版本均已签名,且可追溯到源代码。 每个发布版本都由 release.yml 从标签构建,以不可变发布版本的形式发布;每个压缩包都附带 SPDX SBOM、对
checksums.txt的 cosign 无密钥签名,以及构建来源证明。macOS 二进制文件也使用我的 Developer ID 签名,并经过 Apple 公证。 - CI 会在每次推送时使用 CodeQL 和
govulncheck扫描;如果存在已知且可利用的漏洞,标签版本就无法发布。
使用 GitHub CLI 检查下载文件:
gh attestation verify connect-iq-mcp_<version>_<os>_<arch>.tar.gz --repo idoo/connect-iq-mcp \
--signer-workflow idoo/connect-iq-mcp/.github/workflows/release.yml --source-ref refs/tags/v<version>
或使用 cosign:
cosign verify-blob --bundle checksums.txt.sigstore.json \
--certificate-identity 'https://github.com/idoo/connect-iq-mcp/.github/workflows/release.yml@refs/tags/v<version>' \
--certificate-oidc-issuer https://token.actions.githubusercontent.com checksums.txt
shasum -a 256 -c checksums.txt --ignore-missing
在 Mac 上,spctl -a -vv -t install connect-iq-mcp 应显示 source=Notarized Developer ID。
.mcpb 和 tools.json 列在 checksums-extra.txt 中,并附有各自的 checksums-extra.txt.sigstore.json。上述两种检查方法也同样适用于它们。
非官方
Garmin 没有公开的商店 API,因此 Connect IQ MCP 使用与开发者门户网站相同的私有端点,以及 Garmin 登录功能。Garmin 随时可能更改这些端点,导致功能失效,也可能对此提出异议。续期时会运行一个不会表明自己是自动化程序的无头浏览器,而自动访问可能违反门户网站的条款:这是你的账户,由你决定。请求频率保持较低。
与 Garmin 无关联,也未获其认可。Garmin、Connect IQ 和 fēnix 是 Garmin 的商标。如果 Garmin 对名称提出异议,我们就会更改名称。
对比
| 本项目 | 网页门户 | monkeyc + 手动上传 | wroblisko | andreycooper | |
|---|---|---|---|---|---|
| 可通过你的 Agent 使用 | + | − | − | + | + |
| 商店:评论、安装量、应用列表 | + | + | − | − | − |
| 发布版本 | + | + | ~ | − | − |
| SDK 构建 | + | − | + | + | + |
| 模拟器截图和输入 | + | − | ~ | + | + |
| 在模拟器中进行单元测试 | + | − | + | − | + |
| 预先构建的签名二进制文件 | + | − | − |
~ 表示手动操作。这里和 andreycooper 的项目仅支持在 macOS 上截图和输入模拟器;wroblisko 的项目还支持 Windows。
安全
未经你的许可,它无法发布任何内容。发布版本和编辑应用列表都需要你确认;构建和模拟器操作则不需要确认。即便某条 1 星评论写着“忽略之前的指令”,它也只是一条 1 星评论。更多信息请参阅 docs/SAFETY.md。请私下报告安全漏洞:SECURITY.md。
功能
- “我的应用表现如何?下载量、评分、最新版本。”
- “有新评论吗?为那些愤怒的评论起草回复。”
- “为 fenix 8 构建应用,在模拟器中运行并截屏。”
- “为所有设备构建商店 .iq 文件,并以 1.4.0 发布。”(会先征求你的同意)
- “更新商店描述,其余内容保持不变。”(会先征求你的同意)
- “应用支持哪些设备?我还漏掉了哪些新设备?”
工具按工具集划分,因此你的 Agent 只能看到你使用的工具。store、sdk 和 simulator 默认启用。connect(登录后可访问你的 Garmin Connect 数据,运行 auth login --connect)和 store_experimental(尚未有人在线尝试过的门户调用)默认关闭。通过 CIQ_MCP_TOOLSETS(all、+connect)选择,或在聊天过程中让 Agent 选择。所有工具请参阅:docs/TOOLS.md。
许可证
MIT © Ivan Verevkin
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。