Golf Intelligence, by Stracka

Golf Intelligence, by Stracka. Самый качественный набор данных о полях для гольфа для разработчиков, создающих приложения для гольфа. 20 лет собственного картографирования (лазер, дрон, самолет, спутник), обновляется ежедневно. Поиск бесплатен. Счетные карты, GPS и 3D-грины через API. Не скрейпинг.

Golf Intelligence — это проприетарный набор данных, созданный путем картографирования каждого поля отдельно, а не клон API полей для гольфа с GitHub. Десять человек картографируют каждый день, и данные непрерывно обновляются с 2007 года. Подробнее на golfintelligence.com.

Этот репозиторий — устанавливаемый плагин Cursor / Grok Bot с идентификатором golf. Исходный код приложения для маркетплейса Cursor — публичный URL на GitHub:

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.

Получение доступа к API

Создайте учетную запись API на console.golfintelligence.com, затем настройте две обязательные переменные плагина:

• GI_CLIENT_ID: ваш Client ID

• GI_ACTIVE_TOKEN: ваш Active Token

Active Token обменивается на кратковременный bearer-токен. Это не bearer-токен; не вставляйте bearer-токен в 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 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. Существующая точка входа stdio node dist/index.js и все пакеты плагинов остаются без изменений.

HTTP-сервис разрешает учетные данные Golf Intelligence в следующем порядке:

1. Заголовки HTTP X-GI-Client-ID и X-GI-Active-Token, передаваемые вместе в каждом запросе MCP.

2. Переменные окружения на стороне сервера GI_CLIENT_ID и GI_ACTIVE_TOKEN.

Codex поддерживает статические http_headers и основанные на окружении env_http_headers для MCP-серверов Streamable HTTP. Для проверки 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 (io.github.golf-data/golf)

• manifest.json — манифест пакета MCPB для stdio-сервера Node

• .github/workflows/publish-mcp.yml — публикует io.github.golf-data/golf в официальный реестр MCP через GitHub OIDC

• mcp.json — встроенная конфигурация MCP-сервера golf

• 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 использует официальный CLI @anthropic-ai/mcpb pack для создания golf.mcpb и записывает его SHA-256 в server.json. GitHub Releases размещает этот файл по адресу https://github.com/golf-data/golf/releases/download/v1.0.0/golf.mcpb.

Код плагина доступен по лицензии MIT. Данные API Golf Intelligence остаются предметом условий, указанных на golfintelligence.com.