trackman-mcp

ゴルフコーチ

あなたの統計データだけをもとに指導するゴルフコーチです。ラウンドを重ねるごとに、スクラッチに近づきます。

Golf Coach はあなた自身のアカウントで Trackman Golf にログインし、統計データ（コースでのラウンド、練習セッション、ショット単位の弾道測定データ、クラブごとの飛距離の差、ハンディキャップ）から、どこでストロークを失っているかを診断します。そして、次の練習セッション向けにドリルと YouTube リンク付きの具体的な練習プランを提示し、進捗を長期的に評価します。データツールを提供する MCP サーバーと、コーチングを担う Claude の スキル で構成されています。

利用できること

チャートを読み解く必要はありません。コーチが教えてくれます。Trackman のデータを指定すると、次のことができます。

• 実際にストロークを失っている箇所を特定します。「アイアンを練習しましょう」ではなく、「ドライバーのミスが左右に分かれ、着弾地点が約 115 m の幅に広がっています。飛距離は出ていますが、フェースの向きがまだ安定していません」 と教えてくれます。
• 具体的な練習セッションを 1 つ提示します。クラブ、距離、反復回数、Trackman の目標値に加え、本物の YouTube リンク付きのドリルも提案します。屋内で練習する場合は、ボールを使わない自宅用のルーティンもあります。
• 進捗を評価します。プランを保存し、次のセッションの結果と照らし合わせるので、練習の効果を確認できます。
• 状況を視覚的に示します。ボールの弾道をアニメーションで表示し、ミスの原因となるスイングパスや各目標への到達度を確認できます。

実際のセッション診断：問題点、その原因、目標への到達度、次に練習すべき内容を具体的に示します。

名称について。「Golf Coach」は製品名です。技術的な ID は golf-coach（MCP サーバー／プラグイン）と golf-coach（公開パッケージ）のままなので、既存のインストールは引き続き動作します。

重要

非公式です。 このプロジェクトは Trackman とは提携しておらず、Trackman の承認も受けていません。あなた自身の認証済みセッションのトークンを使って、Trackman の非公開 Web API にアクセスし、あなたに代わってブラウザーでログインします。Trackman の利用規約に抵触する可能性があります。ご自身のアカウントで、自己責任でご利用ください。他人のデータへのアクセスには決して使用しないでください。

設計上の境界

• MCP サーバー ＝ 生データの取得と認証のみ。判断は行いません。
• スキル ＝ コーチング全般（分析、プラン、ドリル）を担います。

アーキテクチャと認証／シークレットのルール全体については、CLAUDE.md を参照してください。

インストール

Claude の使い方に合わせて手順を選んでください。どの方法も約 2 分で完了します。その後、初回のみ 認証 を行ってください。

🖥️ Claude Desktop — ワンクリック（推奨、ターミナル不要）

1. golf-coach.mcpb をダウンロード（最新リリースから）。
2. Claude Desktop → Settings → Extensionsを開き、ファイルをドラッグ＆ドロップ（またはダブルクリック）して、Installをクリックします。トークン欄は空欄のままにします。
3. チャットで**「Trackmanにログインして」と言うと、ブラウザーウィンドウが開きます。Trackmanのメールアドレスとパスワードで一度ログインします（Apple／Googleでのログインも利用できます）。ウィンドウは完了するまで開いたまま**なので、焦らず進めてください。勝手に閉じることはありません。完了したらClaudeに伝えると、ログイン済みであることを確認してくれます。
4. Claudeに「Trackmanのハンディキャップはいくつ？」と尋ねます。

インストールも設定の編集も不要です。Claude Desktopがすべてを実行し、ログイン用のブラウザーを開きます。（初回ログイン時にブラウザーの取得が必要な場合は、少し時間がかかることがあります。「未署名の拡張機能」というメモが表示されることもありますが、ファイルからインストールした場合は想定どおりです。）

プラットフォーム： macOS、Linux、Windows。Claude Desktopは3つの環境すべてでuvを使ってサーバーを実行し、ブラウザーでのログインにはPlaywrightを使用します（クロスプラットフォーム対応）。Windowsでの注意点：ローカルのトークン／データファイルはPOSIXの0600モードではなく、Windowsユーザープロファイル（ACL）によって保護されます。オプションのcron／launchd自動更新スクリプトはmacOS／Linuxのみ対応です。Windowsではタスクスケジューラを使うか、約7日でトークンの有効期限が切れたときにアプリ内で「Trackmanにログイン」を再実行してください。

⌨️ Claude Code — プラグイン（サーバーとコーチングスキル）

/plugin marketplace add bjornj12/golf-coach
/plugin install golf-coach@golf-coach

MCP サーバー（uvx経由で実行）と、10個すべてのコーチングスキルをインストールします。

🔌 その他のMCPクライアント（または拡張機能を使わないClaude Desktop）

uvが必要です（curl -LsSf https://astral.sh/uv/install.sh | sh）。 クライアントのMCP設定に以下を追加します。

{
  "mcpServers": {
    "golf-coach": { "command": "uvx", "args": ["golf-coach"] }
  }
}

Claude Desktopの手動設定（macOSでは~/Library/Application Support/Claude/claude_desktop_config.json）の場合は、uvxの絶対パス（例：/opt/homebrew/bin/uvx）を指定してください。アプリはシェルのPATHを引き継がないためです。上記の.mcpbインストールを使えば、この作業は不要です。

認証（一度だけ）

サーバーがあなたのTrackmanアカウントにログインする必要があります。Trackmanには公開ログインAPIがないため、実際にログインしたブラウザーセッションからトークンを一度取得します。その後はローカルにキャッシュされ、自動で更新されます。このツールがパスワードを参照または保存することはなく、端末の外部にデータが送信されることもありません。

最も簡単な方法 — Claudeにログインを頼む（Claude Desktop／Claude Code）

**「Trackmanにログインして」**と言います。ブラウザーウィンドウ（通常のChromeとは別の独立したプロファイル）が開きます。自分のペースで一度ログインしてください。このウィンドウはバックグラウンドタスクによって操作されるため、完了するまで開いたままで、作業中に閉じられることはありません（Apple／Googleの2段階認証に時間がかかっても問題ありません）。完了したらClaudeに伝えると、確認してくれます。トークンは~/.golf-coach/token.json（モード0600）にキャッシュされ、以降はMCPが自動的に使用します。ターミナル操作もトークンのコピーも不要です。ブラウザーがない場合は、拡張機能が自動で取得します。

ターミナルを使う方法（CLIユーザー向け）

uv tool install "golf-coach[login]"
golf-coach login              # opens a browser; sign in once
golf-coach login --headless   # silent refresh later (tokens last ~7 days)
scripts/install-refresh-schedule.sh   # optional: auto-refresh twice weekly

上級者向け — トークンを貼り付ける

portal.trackmangolf.com → DevTools → Network → graphqlリクエスト → Authorization: Bearer …の値をコピー → 拡張機能のTrackman token欄に貼り付けます（またはTRACKMAN_TOKENを設定します）。トークンは約7日で期限切れになるため、上記のログイン方法のほうが簡単です。

動作確認

Claudeに「Trackmanにログインしていますか？」と尋ねます。auth(action="status")を実行し、名前を返します（トークンは表示されません）。

MCP ツール

すべてのツールは生データのみを返し、スキルが解釈します。

8 個のツール。 trackman と gamebook はそれぞれ action を受け取ります（エージェントは、よく似たツールを複数選ぶのではなく、モードを指定して 1 つのツールを選びます）。

セットアップ： setup — 1 回の呼び出しで、常時有効なコーチ用システムプロンプト（Project 用）、アップロード可能なファイル形式のスキル、クライアントごとの手順を返します。ピッカーには対応する setup プロンプトもあります。

認証： auth(action: status | login, source?)

Trackman データ（読み取り専用）： trackman(action: profile | handicap | sessions | session | rounds | clubs | summary) — プロフィールとハンディキャップ、ハンディキャップ履歴、アクティビティ一覧、アクティビティ 1 件の詳細（ショット単位の指標を含む）、コースラウンド、クラブごとの飛距離差、アクティビティ件数。

Gamebook ラウンド（ローカル、決定論的）： gamebook(action: save | list | get | compare) — Golf GameBook のスクリーンショットから取り込んだコース上のラウンド。直近 5 件を維持し、網羅範囲を考慮（信頼できるのはホールごとのスコアのみ）。

ソース横断の統合（ローカル、決定論的）： synthesize() — ソースごとの Trackman と GameBook の Findings をスキル領域別に対応付けます（結論は出しません。CLAUDE.md の「Sources & normalization」を参照）。

セッション分析（ローカル、決定論的）： session_analysis(action: analyze | get | list)

トレーニングプランの記憶： training_plan(action: save | next | list | done | verify)

可視化： build_visualization（自己完結型のアニメーション付き HTML アーティファクト）

全項目の表とバックエンドの GraphQL については、CLAUDE.md を参照してください。

スキル（コーチングの頭脳）

skills/ にあるスキルは、次の 2 通りで提供されます。

• Claude Code： プラグインと一緒に自動インストールされます。
• あらゆる MCP クライアント（Claude Desktop を含む）： サーバーがスキルを MCP プロンプトとして提供するため、クライアントのプロンプトピッカーに表示されます。別途インストールする必要はありません。

スキル	機能
trackman-stats-analysis	データから弱点を診断します
golf-coaching	診断結果を実践可能な練習プランにまとめます（ビジュアル優先。進捗を自動採点します）
drill-library	厳選されたドリルと検証済みリンクを提供します。自宅でできる／ボール不要のドリルも含み、ライブ検索にも対応します
golf-practice-at-home	診断された課題に合わせた毎日のボール不要ルーティンを、ドリルごとのアニメーション付きで作成します
at-home-practice-feedback	フィードバック機能を内蔵した、モバイル優先の単一のドリルカードです。小道具、確認ポイント、予算区分、動画を含みます
trackman-session-analyzer	最近のセッションを取り込み、正規化します
gamebook-screenshot-analysis	GameBook のラウンドスクリーンショットを、網羅範囲を考慮したラウンド記録に取り込みます。スコアを重視した進捗を記録し、コーチに反映します
swing-video-check	撮影したスイングを、現在の練習カードに照らしてフレームごとに視覚的に確認します（クリップごとに 1 アングル）
grip-check	正面から撮影した 2 枚の写真をもとにグリップを採点します（弱すぎる／強すぎる）。新たな処方を行う前にコーチが確認します
trackman-visualizer	診断結果（または 1 つのドリルの動き）を HTML アーティファクトとしてアニメーション表示します

撮影したスイングを確認するには、DATE_CLUB_ACTION.mp4 という名前のクリップ（例： 2026-07-17_driver_grip-reset.mp4）を Claude Code のプロジェクトに追加し、 「スイングをチェックして」と伝えてください。アングルに絞ったチェックリストと、スイングのポイントが 1 つ提示されます （ffmpeg が必要です）。

（trackman-api-discovery はプロジェクト／開発用スキルであり、プロンプトとしては提供されません。）

開発

uv venv && uv pip install -e '.[login,dev]'   # [login] = Playwright, [dev] = test/lint tools

golf-coach                       # run the MCP server (stdio)
uv run python scripts/validate.py  # sanity-check stats coverage with your token

uv run pytest        # tests
uv run ruff check    # lint
uv run mypy          # type-check

リリース（PyPI + MCP Registry + Desktop 用 .mcpb）は、scripts/release.sh patch の 1 コマンドで実行できます。詳しくは PUBLISHING.md を参照してください。

ライセンス

MIT