AIクライアントから、スコアカード、GPS座標、3Dグリーン傾斜画像などの独自のゴルフコースデータにアクセスできます。
別名 golf-data/golf, golf
- スター
- 4
- ツール
- 5
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.0.7
- 最終コミット
- 2026年10月31日
- ライセンス
- MIT
Golf Course Data by Stracka MCPとは
Golf Course Data by StrackaはMCPサーバーです。 AIクライアントから、スコアカード、GPS座標、3Dグリーン傾斜画像などの独自のゴルフコースデータにアクセスできます。. 5個のツールを提供しており、search_course_groups, get_course_group_scorecard, get_course_group_gpsなどがあります。
プロジェクトのREADMEから生成された概要
Golf Course Data by Stracka MCP server について
このMCP serverを使用すると、AIクライアントを通じて独自のゴルフコース情報にアクセスできます。スコアカード、GPS座標、3Dグリーン傾斜画像など、毎日更新されるデータを開発者やゴルフ愛好家に提供します。このサーバーは、streamable HTTP経由のホストされたMCP接続、またはオフライン開発用のローカルstdioサーバーとして機能します。
利用には、Golf Intelligenceアカウントから取得したClient IDとActive Tokenを使用して接続を設定する必要があります。サービスはクレジット制を採用しており、100クレジットのTesterプランや10,000クレジットのStarterプランなどの異なる月額プランがあります。予期せぬコストを防ぐため、get_course_group_gpsやget_green_slope_imageなどの有料ツールを実行する前には、サーバーによる明示的な確認が求められます。
コースグループの検索は無料ですが、その他の特定のデータ取得にはクレジットを消費します。システムは安全に設計されており、認証情報を短期間有効なbearer tokenと交換し、そのトークンはメモリ内のみにキャッシュされます。OAuth 2.1を介して、Cursor、Claude Code、ChatGPTを含むさまざまな環境をサポートしています。
できること
- 1コーススコアカードの取得特定のゴルフコースグループのスコアカードデータを取得するようAIに依頼します。
- 2グリーンの地形分析特定のホールの地形を把握するために、3Dグリーン傾斜画像をリクエストします。
- 3コース形状のマッピングAIを使用して、マッピングされたコース形状やGPS座標を取得します。
- 4ゴルフコースの検索アカウントのクレジットを消費せずに、特定のコースグループを検索します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Golf Course Data by Stracka MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにGolf Course Data by Stracka MCPをインストール
$ claude mcp add --transport http golf https://mcp.golfintelligence.com/mcpCursorにGolf Course Data by Stracka MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"golf": {
"url": "https://mcp.golfintelligence.com/mcp"
}
}
}VS CodeにGolf Course Data by Stracka MCPをインストール
.vscode/mcp.json
{
"servers": {
"golf": {
"type": "http",
"url": "https://mcp.golfintelligence.com/mcp"
}
}
}VS Code CLIにGolf Course Data by Stracka MCPをインストール
$ code --add-mcp '{"name":"golf","type":"http","url":"https://mcp.golfintelligence.com/mcp"}'CodexにGolf Course Data by Stracka MCPをインストール
$ codex mcp add golf --url https://mcp.golfintelligence.com/mcpCodex config.tomlにGolf Course Data by Stracka MCPをインストール
~/.codex/config.toml
[mcp_servers.golf] url = "https://mcp.golfintelligence.com/mcp"
Gemini CLIにGolf Course Data by Stracka MCPをインストール
$ gemini mcp add -s user --transport http golf https://mcp.golfintelligence.com/mcpGemini settings.jsonにGolf Course Data by Stracka MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"golf": {
"url": "https://mcp.golfintelligence.com/mcp",
"type": "http"
}
}
}Golf Course Data by Stracka MCPツール 5
READMEから検出search_course_groupsget_course_group_scorecardget_course_group_gpsget_course_group_detailget_green_slope_image
| search_course_groups | — | |
| get_course_group_scorecard | — | |
| get_course_group_gps | — | |
| get_course_group_detail | — | |
| get_green_slope_image | — |
設定
GI_ACTIVE_TOKEN必須シークレットActive Token from API Account at console.golfintelligence.com. It is exchanged for a bearer token; do not enter a bearer token.
GI_CLIENT_ID必須Client ID from API Account at console.golfintelligence.com.
| 名前 | 説明 | 種類 |
|---|---|---|
| GI_ACTIVE_TOKEN | Active Token from API Account at console.golfintelligence.com. It is exchanged for a bearer token; do not enter a bearer token. | 必須シークレット |
| GI_CLIENT_ID | Client ID from API Account at console.golfintelligence.com. | 必須 |
自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない未チェック
- リモートエンドポイントがHTTPSを使用合格
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
README
GitHubで見るGolf Course Data by Stracka
Golf Course Data by Stracka. Proprietary StrackaGolf course data only, updated daily. Search is free. Scorecards, GPS, and 3D greens via API.
Golf Intelligence provides proprietary StrackaGolf course data, updated daily. Learn more at golfintelligence.com.
This repository is the installable Cursor / Grok Bot plugin with handle
golf. The Cursor marketplace application source is the public GitHub URL:
https://github.com/golf-data/golf
Marketplace reviewers can submit that URL at cursor.com/marketplace/publish. The catalog title is Golf Course Data by Stracka.
The bundled mcp.json connects to the hosted MCP at
https://mcp.golfintelligence.com/mcp over Streamable HTTP, so installing the
plugin never depends on a local Node build. Your console credentials travel as
the X-GI-Client-ID and X-GI-Active-Token headers, filled from the plugin
variables declared in .cursor-plugin/plugin.json.
Earlier releases launched node against a plugin-relative dist/index.js.
Cursor does not expand the Agent Plugins ${PLUGIN_ROOT} variable, so that
placeholder reached Node literally and the connector failed with
Cannot find module '.../${PLUGIN_ROOT}/dist/index.js'. The hosted connector
removes that failure mode entirely.
mcp.stdio.json keeps the local stdio server for offline and development use.
It is not auto-discovered; copy its golf entry into .cursor/mcp.json (using
${workspaceFolder} in a checkout) or point mcpServers at it. Any local
stdio config must use ${CURSOR_PLUGIN_ROOT}, never ${PLUGIN_ROOT}. The
committed dist/index.js bundle ships in the repository and in the MCPB
package, so the stdio path works without running a build first.
The official MCP Registry name is io.github.golf-data/golf. The registry
does not accept a bare golf name. Cursor, Agent Plugins, and Claude Code
plugin handles remain golf.
Get API access
Sign in at console.golfintelligence.com without a password: enter your email on the login page, request a verification code, then enter the code after it is sent. Create an API Account and configure the plugin's two required variables:
GI_CLIENT_ID: your Client IDGI_ACTIVE_TOKEN: your Active Token
The Active Token is exchanged for a short-lived bearer token. It is not a
bearer token; do not paste a bearer token into GI_ACTIVE_TOKEN.
Use credentials from your own console account. This project does not provide demo tokens.
Plans are monthly and can be upgraded or downgraded self-serve in the console:
- Tester: $49/month for 100 credits/month.
- Starter: $399/month for 10,000 credits/month.
For billing, credits, plans, login, or credential help, email support@golfintelligence.com. For course data updates, email data@golfintelligence.com.
Tools and credits
Always search first. search_course_groups is free. Before every paid call,
the user must explicitly confirm the stated cost; the server refuses paid tools
unless confirm_spend=true.
| Tool | What it returns | Credits |
|---|---|---|
search_course_groups |
Course-group search results | 0 |
get_course_group_scorecard |
Scorecard data | 1 |
get_course_group_gps |
Mapped course geometry and coordinates | 2 |
get_course_group_detail |
Detailed course-group data | 3 |
get_green_slope_image |
Portrait or square green slope image | 1 |
Authentication
The local stdio server and legacy per-user HTTP credential headers exchange the configured credentials with:
POST https://api.golfintelligence.com/auth/authenticateToken
grant_type=client_credentials
code=<GI_ACTIVE_TOKEN>
client_id=<GI_CLIENT_ID>
It sends the returned access_token as Authorization: Bearer <access_token>,
caches it only in memory, and refreshes once after an HTTP 401. Credentials are
never logged.
The hosted MCP additionally implements OAuth 2.1 authorization-code flow with S256 PKCE for ChatGPT. Its dedicated authorization page accepts each user's own console Client ID and Active Token, validates them with Golf Intelligence, and binds that account to encrypted access and refresh tokens. See docs/OPENAI-CHATGPT-OAUTH.md for discovery URLs, OpenAI portal settings, reviewer steps, and deployment secrets.
Streamable HTTP
The hosted MCP is available via the official MCP Streamable HTTP transport at:
https://mcp.golfintelligence.com/mcp
The production HTTP entrypoint serves that transport at /mcp and a health
check at /health. For OpenAI Apps domain verification it also serves
GET /.well-known/openai-apps-challenge as text/plain when
OPENAI_APPS_CHALLENGE_TOKEN (or OPENAI_APPS_CHALLENGE) is set; otherwise
that path returns 404. Start the HTTP server locally with:
npm run build
PORT=3000 npm run start:http
It binds to 0.0.0.0:$PORT. The existing node dist/index.js stdio entrypoint
and all plugin packages remain unchanged.
The HTTP service accepts Golf Intelligence identity in either of these forms:
- An OAuth bearer token issued by this service after the user signs in with their own GI account.
- Legacy
X-GI-Client-IDandX-GI-Active-Tokenheaders supplied together on every MCP request by existing plugin installs.
There is deliberately no server-wide GI_CLIENT_ID / GI_ACTIVE_TOKEN
fallback. The HTTP entrypoint ignores those environment variables, so an
anonymous caller cannot inherit a deployment account or spend its credits.
Missing or invalid OAuth returns HTTP 401 with an OAuth protected-resource
challenge. The Active Token is an exchange credential and must not be sent as
an Authorization: Bearer value.
Every tool explicitly advertises these MCP annotations:
readOnlyHint: true— each tool only retrieves course data.openWorldHint: false— no tool writes to public or external systems.destructiveHint: false— no tool deletes, overwrites, publishes, or sends anything.idempotentHint: truefor free search.idempotentHint: falsefor paid tools because every repeated paid invocation can consume credits again.
These sentences can also be used as the annotation justifications in the
OpenAI submission form. Paid lookups still require confirm_spend=true at the
same credit costs documented above.
Container deployment
Dockerfile builds both transports without embedding credentials.
fly.toml configures a small Fly.io service and checks /health. Before the
first deploy, confirm that the globally unique Fly app name is available (or
change app), then configure the OAuth secrets documented in
docs/OPENAI-CHATGPT-OAUTH.md and deploy. At minimum:
fly volumes create oauth_state --region ord --size 1
fly secrets set OAUTH_ENCRYPTION_KEY="$(openssl rand -base64 32)"
fly secrets set OAUTH_ISSUER=https://mcp.golfintelligence.com
fly secrets set OPENAI_APPS_CHALLENGE_TOKEN=...
fly deploy
The mounted volume stores OAuth replay/rotation state, not GI credentials. Run one Machine for this file-backed state store.
Do not configure a shared GI account for hosted HTTP callers. If
GI_CLIENT_ID / GI_ACTIVE_TOKEN exist for a separate bootstrap or stdio
workflow, they do not authorize HTTP requests.
Set OPENAI_APPS_CHALLENGE_TOKEN to the token shown in OpenAI Platform domain
verification. Do not commit that token. After deploy,
GET https://mcp.golfintelligence.com/.well-known/openai-apps-challenge
should return the token as text/plain.
Tool names and descriptions are baked into the deployed bundle, so the hosted
MCP keeps serving the previous copy until it is redeployed. Redeploy before
refreshing the marketplace listing, and follow docs/RELEASE.md for the full
order across Fly, the marketplace, and the MCP Registry.
Repository layout
.cursor-plugin/plugin.json— Cursor marketplace manifest and required variablesplugin.json— Agent Plugins open-standard manifest (handlegolf).claude-plugin/plugin.json— Claude Code / Cowork plugin manifest (handlegolf)server.json— official MCP Registry metadata (io.github.golf-data/golf)manifest.json— MCPB bundle manifest for the stdio Node server.github/workflows/publish-mcp.yml— publishesio.github.golf-data/golfto the official MCP Registry via GitHub OIDCmcp.json— bundledgolfconnector pointing at the hosted MCP endpointmcp.stdio.json— optional local stdio configuration for offline developmentskills/golf/SKILL.md— workflow and spend-confirmation guidancedocs/SMOKE-CHECKLIST.md— post-deploy and post-publish verification stepsdocs/RELEASE.md— Fly redeploy, GitHub release, and registry publish runbooksrc/— TypeScript MCP server and API clientdist/index.js— committed stdio ESM bundle used by installersdist/http.js— committed Streamable HTTP ESM bundle used by the containerDockerfileandfly.toml— production HTTP container and Fly.io service
For development with Node.js 18 or newer:
npm install
npm test
npm run build
npm run pack:mcpb
pack:mcpb uses the official @anthropic-ai/mcpb pack CLI to produce golf.mcpb and writes its SHA-256 into server.json. GitHub Releases host that asset at https://github.com/golf-data/golf/releases/download/v1.0.2/golf.mcpb.
The plugin code is available under the MIT License. Golf Intelligence API data remains subject to the terms at golfintelligence.com.
Golf Course Data by Stracka MCPのよくある質問
Golf Course Data by Stracka MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http golf https://mcp.golfintelligence.com/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Golf Course Data by Stracka MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Golf Course Data by Stracka MCPが提供するツールは
5個のツールを提供しており、search_course_groups, get_course_group_scorecard, get_course_group_gps, get_course_group_detail, get_green_slope_imageなどがあります。
APIの利用料金はいくらですか?
料金は月額プランに基づいています。Testerプランは月額49ドルで100クレジット、Starterプランは月額399ドルで10,000クレジットです。