Golf Intelligence, by Stracka

Golf Intelligence, by Stracka。ゴルフアプリを開発する開発者向けの最高品質のゴルフコースデータセット。20年にわたる独自のマッピング（レーザー、ドローン、航空機、衛星）を毎日更新。検索は無料。API経由でスコアカード、GPS、3Dグリーンを提供。スクレイピングではありません。

Golf Intelligenceは、コースごとのマッピングによって構築された独自のデータセットであり、GitHubのゴルフコースAPIのクローンではありません。毎日10人がマッピングを行い、データは2007年から継続的に更新されています。詳細はgolfintelligence.comをご覧ください。

このリポジトリは、ハンドルgolfを持つインストール可能なCursor / Grok Botプラグインです。Cursorマーケットプレイスアプリケーションのソースは、公開GitHub URLです：

https://github.com/golf-data/golf

マーケットプレイスのレビュアーは、そのURLをcursor.com/marketplace/publishで提出できます。カタログタイトルはGolf Intelligence, by Strackaです。

公式MCPレジストリ名は**io.github.golf-data/golf**です。レジストリは裸のgolf名を受け付けません。Cursor、Agent Plugins、Claude Codeのプラグインハンドルはgolfのままです。

Get API access

APIアカウントをconsole.golfintelligence.comで作成し、プラグインの2つの必須変数を設定してください：

• GI_CLIENT_ID: あなたのClient ID

• GI_ACTIVE_TOKEN: あなたのActive Token

Active Tokenは短期間有効なベアラートークンと交換されます。これはベアラートークンではありません。GI_ACTIVE_TOKENにベアラートークンを貼り付けないでください。

プラン：

• Personal: 自分のゲーム用のCursor、Grok、またはClaudeアプリ向けに50テストクレジットで$49。 Buy Personal。

• Starter: 他のユーザーにアプリを提供する場合、月額$399で10,000クレジット。 data@golfintelligence.com までメールしてください。Starterにはチェックアウトリンクはありません。

データ、プラン、統合に関する質問：data@golfintelligence.com。

Related MCP server: Korea Ground-Truth MCP

Tools and credits

常に最初に検索してください。search_course_groupsは無料です。有料の呼び出しの前に、ユーザーは明示的に記載されたコストを確認する必要があります。サーバーはconfirm_spend=trueでない限り有料ツールを拒否します。

Authentication

サーバーは設定された認証情報を次のものと交換します：

POST https://api.golfintelligence.com/auth/authenticateToken
grant_type=client_credentials
code=<GI_ACTIVE_TOKEN>
client_id=<GI_CLIENT_ID>

サーバーは返されたaccess_tokenをAuthorization: Bearer <access_token>として送信し、メモリ内にのみキャッシュし、HTTP 401の後に一度だけ更新します。認証情報がログに記録されることはありません。

Streamable HTTP

本番HTTPエントリポイントは、公式MCP Streamable HTTPトランスポートを/mcpで提供し、ヘルスチェックを/healthで提供します。想定されるカスタムドメインURLの形式は次のとおりです：

https://mcp.golfintelligence.com/mcp

このリポジトリはそのURLが稼働しているとは主張しません。レビューに提出する前にDNSとデプロイを完了する必要があります。HTTPサーバーをローカルで起動するには：

npm run build
PORT=3000 npm run start:http

0.0.0.0:$PORTにバインドします。既存のnode dist/index.js stdioエントリポイントとすべてのプラグインパッケージは変更されません。

HTTPサービスはGolf Intelligenceの認証情報を次の順序で解決します：

1. すべてのMCPリクエストで一緒に提供されるX-GI-Client-IDおよびX-GI-Active-Token HTTPヘッダー。

2. サーバー側のGI_CLIENT_IDおよびGI_ACTIVE_TOKEN環境変数。

Codexは、Streamable HTTP MCPサーバー向けに静的http_headersと環境変数ベースのenv_http_headersをサポートしています。OpenAIのレビューのために、デプロイメント環境変数として専用のレビューAPIアカウントを設定するか、レビュー設定がサポートしている場合は2つのカスタムヘッダーを提供してください。Active Tokenは交換用の認証情報のままであり、Authorization: Bearer値として送信してはなりません。本番デプロイでは、環境ベースの認証情報によりルックアップツールがパブリックエンドポイントのすべての呼び出し元に利用可能になるため、適切なクレジット制限を持つ専用アカウントを使用する必要があります。

すべてのツールは、以下のMCPアノテーションを明示的に宣伝しています：

• readOnlyHint: true — 各ツールはコースデータのみを取得します。

• openWorldHint: false — 公開システムや外部システムに書き込むツールはありません。

• destructiveHint: false — 削除、上書き、公開、送信を行うツールはありません。

• idempotentHint: true — ルックアップを繰り返しても追加の副作用はありません。

これらの文は、OpenAI提出フォームのアノテーションの正当性としても使用できます。有料ルックアップには、上記で文書化された同じクレジットコストでconfirm_spend=trueが依然として必要です。

Container deployment

Dockerfileは認証情報を埋め込まずに両方のトランスポートをビルドします。fly.tomlは小さなFly.ioサービスを構成し、/healthをチェックします。最初のデプロイの前に、グローバルに一意なFlyアプリ名が利用可能であることを確認し（またはappを変更し）、ランタイムシークレットを設定してデプロイしてください：

fly secrets set GI_CLIENT_ID=... GI_ACTIVE_TOKEN=...
fly deploy

デプロイされた*.fly.devエンドポイントがMCP Inspectorチェックに合格した後にのみ、カスタムドメインを設定してください。このリポジトリによるデプロイは実行されません。

Repository layout

• .cursor-plugin/plugin.json — Cursorマーケットプレイスマニフェストと必須変数

• plugin.json — Agent Pluginsオープンスタンダードマニフェスト（ハンドルgolf）

• .claude-plugin/plugin.json — Claude Code / Coworkプラグインマニフェスト（ハンドルgolf）

• server.json — 公式MCPレジストリメタデータ（io.github.golf-data/golf）

• manifest.json — stdio Nodeサーバー用のMCPBバンドルマニフェスト

• .github/workflows/publish-mcp.yml — GitHub OIDCを介してio.github.golf-data/golfを公式MCPレジストリに公開

• mcp.json — バンドルされたgolf MCPサーバー構成

• skills/golf/SKILL.md — ワークフローと支出確認のガイダンス

• src/ — TypeScript MCPサーバーとAPIクライアント

• dist/index.js — インストーラーが使用するコミット済みstdio ESMバンドル

• dist/http.js — コンテナが使用するコミット済みStreamable HTTP ESMバンドル

• Dockerfile and fly.toml — 本番HTTPコンテナとFly.ioサービス

Node.js 18以降での開発には：

npm install
npm test
npm run build
npm run pack:mcpb

pack:mcpbは公式の@anthropic-ai/mcpb pack CLIを使用してgolf.mcpbを生成し、そのSHA-256をserver.jsonに書き込みます。GitHub Releasesはそのアセットをhttps://github.com/golf-data/golf/releases/download/v1.0.0/golf.mcpbでホストします。

プラグインコードはMITライセンスの下で利用可能です。Golf Intelligence APIデータは、golfintelligence.comの利用規約に従います。