Golf Intelligence，作者 Stracka

Golf Intelligence，作者 Stracka。为构建高尔夫应用的开发者提供最高质量的高尔夫球场数据集。20 年专有测绘数据（激光、无人机、飞机、卫星），每日更新。搜索免费。通过 API 提供记分卡、GPS 和 3D 果岭。非抓取数据。

Golf Intelligence 是一个专有数据集，通过逐球场测绘构建，而非 GitHub 高尔夫球场 API 的克隆。每天有十人进行测绘，数据自 2007 年起持续更新。了解更多请访问 golfintelligence.com。

本仓库是可安装的 Cursor / Grok Bot 插件，句柄为 golf。Cursor 市场应用源代码的公开 GitHub URL 为：

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

市场审核人员可在 cursor.com/marketplace/publish 提交该 URL。目录标题为 Golf Intelligence，作者 Stracka。

官方 MCP Registry 名称为 io.github.golf-data/golf。Registry 不接受裸 golf 名称。Cursor、Agent Plugins 和 Claude Code 插件句柄仍为 golf。

获取 API 访问权限

在 console.golfintelligence.com 创建 API 账户，然后配置插件的两个必需变量：

• GI_CLIENT_ID：你的 Client ID

• GI_ACTIVE_TOKEN：你的 Active Token

Active Token 用于换取短期 bearer token。它不是 bearer token；请勿将 bearer token 粘贴到 GI_ACTIVE_TOKEN 中。

套餐：

• Personal： 49 美元，含 50 个测试积分，适用于你自己的 Cursor、Grok 或 Claude 应用。购买 Personal。

• Starter： 399 美元/月，含 10,000 个积分，适用于向其他用户发布应用。请发送邮件至 data@golfintelligence.com； Starter 没有结账链接。

有关数据、套餐或集成的问题： data@golfintelligence.com。

Related MCP server: Korea Ground-Truth MCP

工具与积分

始终先搜索。search_course_groups 免费。每次付费调用前，用户必须明确确认所述费用；服务器在 confirm_spend=true 之前拒绝付费工具。

认证

服务器将配置的凭据与以下端点进行交换：

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 提供官方 MCP Streamable HTTP 传输，并在 /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 账户配置为部署环境变量，要么在审核配置支持的情况下提供两个自定义头。Active Token 仍然是交换凭据，不得作为 Authorization: Bearer 值发送。生产部署应使用具有适当积分额度的专用账户，因为基于环境的凭据会使查询工具对公共端点的每个调用者都可用。

每个工具都明确声明以下 MCP 注解：

• readOnlyHint: true — 每个工具仅检索球场数据。

• openWorldHint: false — 没有工具写入公共或外部系统。

• destructiveHint: false — 没有工具删除、覆盖、发布或发送任何内容。

• idempotentHint: true — 重复查询没有额外副作用。

这些句子也可以用作 OpenAI 提交表单中的注解理由。付费查询仍需要 confirm_spend=true，积分费用与上述文档一致。

容器部署

Dockerfile 构建两种传输方式，不嵌入凭据。 fly.toml 配置一个小型 Fly.io 服务并检查 /health。在 首次部署之前，确认全局唯一的 Fly 应用名称可用（或更改 app），然后设置运行时密钥并部署：

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

仅在部署的 *.fly.dev 端点通过 MCP Inspector 检查后，才设置自定义域名。本仓库不执行任何部署。

仓库结构

• .cursor-plugin/plugin.json — Cursor 市场清单和必需变量

• plugin.json — Agent Plugins 开放标准清单（句柄 golf）

• .claude-plugin/plugin.json — Claude Code / Cowork 插件清单（句柄 golf）

• server.json — 官方 MCP Registry 元数据（io.github.golf-data/golf）

• manifest.json — stdio Node 服务器的 MCPB 捆绑清单

• .github/workflows/publish-mcp.yml — 通过 GitHub OIDC 将 io.github.golf-data/golf 发布到官方 MCP Registry

• mcp.json — 捆绑的 golf MCP 服务器配置

• skills/golf/SKILL.md — 工作流和消费确认指南

• src/ — TypeScript MCP 服务器和 API 客户端

• dist/index.js — 安装程序使用的已提交 stdio ESM 捆绑包

• dist/http.js — 容器使用的已提交 Streamable HTTP ESM 捆绑包

• Dockerfile 和 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 License 提供。Golf Intelligence API 数据 仍受 golfintelligence.com 上的条款约束。