Connect IQ MCP

Connect IQ MCP

Garmin Connect IQ 開発者向けの MCP サーバーです。エージェントから、ストア（バージョン、掲載情報、レビュー、インストール数）、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

または、手動で次の 3 ステップを実行します。

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 は OS のキーチェーンに保存され、ツールが 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.sigstore.json とともに checksums-extra.txt に記載されています。どちらも、上記と同じ方法で確認できます。

非公式

Garmin には公開ストア API がないため、Connect IQ MCP は開発者ポータルのウェブサイトと同じ非公開エンドポイントに加え、Garmin のサインイン機能を使用します。Garmin はいつでもこれらを変更して動作しなくしたり、異議を申し立てたりする可能性があります。認証の更新には、自動化されていることを明かさないヘッドレスブラウザーを使用します。また、自動アクセスはポータルの利用規約に違反する可能性があります。使用するかどうかは、ご自身のアカウントでご自身で判断してください。リクエスト頻度は低く抑えています。

Garmin とは提携しておらず、Garmin からの推奨も受けていません。Garmin、Connect IQ、fēnix は Garmin の商標です。Garmin から名称について異議があれば、名称を変更します。

比較

	このツール	ウェブポータル	monkeyc ＋ 手動アップロード	wroblisko	andreycooper
エージェントから利用可能	+	−	−	+	+
ストア：レビュー、インストール、掲載情報	+	+	−	−	−
バージョンを公開	+	+	~	−	−
SDK ビルド	+	−	+	+	+
シミュレーターのスクリーンショットと入力	+	−	~	+	+
シミュレーターでのユニットテスト	+	−	+	−	+
署名済みバイナリを事前ビルド	+			−	−

~ は手作業です。ここおよび andreycooper ではスクリーンショットとシミュレーター入力は macOS のみ対応しています。wroblisko は Windows にも対応しています。

セキュリティ

許可するまでは、何も公開できません。バージョンの公開と掲載情報の編集には確認が必要ですが、ビルドとシミュレーターでは確認を求めません。「以前の指示を無視しろ」と書かれた星 1 つのレビューも、単なる星 1 つのレビューです。詳しくは docs/SAFETY.md をご覧ください。脆弱性は非公開で報告してください：SECURITY.md。

できること

• 「アプリの状況はどうですか？ダウンロード数、評価、最新バージョンは？」
• 「新しいレビューはありますか？厳しいレビューへの返信案を作成して。」
• 「fenix 8 向けにアプリをビルドして、シミュレーターで実行し、スクリーンショットを撮って。」
• 「すべてのデバイス向けにストア用の .iq をビルドして、1.4.0 として公開して。」（先に確認します）
• 「ストアの説明を更新して、ほかはそのままにして。」（先に確認します）
• 「このアプリが対応しているデバイスと、新たに対応が必要なデバイスを教えて。」

ツールはツールセットにまとめられているため、エージェントには使用するものだけが表示されます。store、sdk、simulator は初期状態で有効です。connect（auth login --connect の実行後に利用できる Garmin Connect データ）と store_experimental（実環境でまだ試されていないポータル呼び出し）は無効です。CIQ_MCP_TOOLSETS（all、+connect）で選択するか、チャット中にエージェントへ依頼してください。すべてのツール：docs/TOOLS.md。

ライセンス

MIT © Ivan Verevkin